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To be continued ... 未 完 待 续 ... 


REST in Action CREST 实战 》 


REST in Action base on Jersey.Learning REST step by step with a large number 
of samples and finally build a complete RESTful application.There is also a 
GitBook version of the book: http://waylau.gitbooks.io/rest-in-action. Let's READ! 


基于 Jersey 的 REST 实战 。 在 做 Java RESTful 相关 的 项 目 ， 发 现 网 上 中 文 的 资料 
比较 少 (https://github.com/waylau/RestDemo 这 个 是 我 以 前 写 的 博客 ， 可 以 作为 
参考 ) ， 而 且 Jersey 的 更 新 比较 快 ， 利 用 业余 时 9 5 d 本 书 ， 图 文 并 成 ， 用 大 量 
实例 带 你 一 步 一 步 走 进 REST 的 世界 ， 有 最 终 构建 完整 的 REST ÈM » def S 
漏 欢迎 指正 。 感 谢 您 的 参与 | 


AK Jersey 详细 信息 ， 可 以 参阅 《Jersey 2.x 用 户 指南 》。 
Get start 如 何 开 始 阅 读 


选择 下 面 入 口 之 一 : 


e https://github.com/waylau/rest-in-action 的 SUMMARY.md 

e http://git.oschina.net/waylau/rest-in-action 的 SUMMARY.md (国内 访问 速度 
快 ) 

e http://waylau.gitbooks.io/rest-in-action 的 Read 按钮 


Code 12.45 


书 中 所 有 示例 源码 ， 移 步 至 https://github.com/waylau/rest-in-action 的 ”samples 
目录 下 ,代码 遵循 《Java 编码 规范 》 


lssue 意见 、 建 议 


如 有 勘误 、 意 见 或 建议 欢迎 拍 砖 https://github.com/waylau/rest-in-action/issues 


Contact 联系 作者 : 


e Blog: waylau.com 


Introduction 


e Gmail: waylau521(at)gmail.com 
e Weibo: waylau521 

e Twitter: waylau521 

e Github : waylau 


REST Overview 


About REST 


REST X X x: Representational State Transfer 的 缩写 ， 有 中 文 翻译 为 “表述 性 状态 
转移 ”。REST 这 个 术语 是 由 Roy Fielding a « Architectural Styles 
and the Design of Network-based Software Architectures ) ¥ 4218 8j » REST 并 非 
标准 ， 而 是 一 种 开发 Web 应 用 的 架构 风格 ， 可 以 将 其 理解 为 一 种 设计 模式 。 REST 
基于 HTTP，URI， 以 及 XML 这 些 现 有 的 广泛 流行 的 协议 和 标准 ， 伴 随 着 REST > 
HTTP 协议 得 到 了 更 加 正确 的 使 用 。 


J SOAP 和 WSDL 的 Web 服务 ，REST 模式 提供 了 更 为 简洁 的 实现 方 
° REST Web 服务 (RESTful web services) 是 松 耦 合 的 ， 这 特别 适用 于 为 客户 创 
ey ree Web 服务 API » REST 应 用 是 围绕 “资源 表述 的 转移 
(the transfer of representations of resources) "为 中 心 来 做 请 求 和 响应 。 数 据 和 
功能 均 被 视 为 资源 ， 并 使 用 统一 资源 标识 符 (URI) 来 访问 资源 。 网 页 里 面 的 链接 
就 是 典型 的 URI o 该 资源 由 文档 表述 ， 并 通过 使 用 一 组 简单 的 、 定 义 明确 的 操作 来 
执行 。 


例如 ， 一 个 REST 资源 可 能 是 一 个 城市 当前 的 天 气 情 况 。 该 资源 的 表述 可 能 是 一 个 
XML 文 档 ， 图 像 文件 ， 或 HTM LL 页面。 客户 端 可 以 检索 特定 表述 ， 通 过 更 新 其 数据 
修改 的 资源 ， 或 者 完全 删除 该 资源 。 


目前 ， 越 来 越 多 的 Web 服务 开始 采用 REST PUE tt Fe KHL > AERP eR a 
名 的 REST 服务 包括 : Google AJAX 搜索 API > Amazon Simple Storage Service 
(Amazon S3) 等 。 


基于 REST Web 服务 遵循 一 些 基本 的 设计 原则 ， 使 得 RESTful 应 用 更 加 简单 、 
轻 量 ? 开发 速度 度 也 更 快 


通过 URI 来 标识 资源 :系统 中 的 每 一 个 对 象 或 是 资源 都 可 以 通过 一 个 唯一 的 
URI 来 进行 寻 址 ，URI 的 结构 应 该 简单 、 可 预测 且 钨 于 理解 ， 比 如 定义 目录 结 
构 式 的 URI ° 

e 统一 接口 : 以 遵循 RFC-2616 所 定义 的 协议 的 方式 显 式 地 使 用 HTTP 方法 ， 建 
立 创建 、 检 索 、 更 新 和 删除 (CRUD : Create, Retrieve, Update and Delete) 
操作 与 HTTP 方法 之 间 的 一 对 一 映射 : 


o 若 要 在 服务 器 上 创建 资源 ， 应 该 使 用 POST X: 
o 若 要 检索 某 个 资源 ， 应 该 使 用 GET 方法 ; 

o 若 要 更 新 或 者 添加 资源 ， 应 该 使 用 PUT 方法 ; 

o 若 要 删除 某 个 资源 ， 应 该 使 用 DELETE 方法 。 

e 资源 多 重 表 述 :URI 所 访问 的 每 个 资源 都 可 以 使 用 不 同 的 形式 加 以 表示 (比如 
XML 或 者 JSON) ， 有 具体 的 表现 形式 取决 于 访问 资源 的 客户 端 ， 客 户 端 与 服务 
提供 者 使 用 一 种 内 容 协 商 的 机 制 (请 求 头 与 MIME 类 型 ) 来 选择 合适 的 数据 格 
式 ， 最 小 化 彼此 之 间 的 数据 耦合 。 在 REST 的 世界 中 ， 资 源 即 状态 ， 而 互联 网 
就 是 一 个 巨大 的 状态 机 ， 每 个 网 页 是 其 一 个 状态 ; URI 是 状态 的 表述 ; REST 
风格 的 应 用 则 是 从 一 个 状态 迁移 到 下 一 个 状态 的 状态 转移 过 程 。 早 期 互联 网 只 
有 静态 页 面 的 时 候 ， 通 过 超 链 接 在 静态 网 页 问 浏览 跳 转 的 page->link->page- 
»link... 模式 就 是 一 种 典型 的 状态 转移 过 程 。 也 就 是 说 早期 的 互联 网 就 是 天 然 的 
REST 

e 无 状态 :对 服务 器 端的 请 求 应 该 是 无 状态 的 ， 完 整 、 独 立 的 请 求 不 要 求 服务 器 在 
处 理 请 求 时 检索 任何 类 型 的 应 用 程序 上 下 文 或 状态 。 无 状态 约束 使 服务 器 的 变 
化 对 客户 端 是 不 可 见 的 ， 因 为 在 两 次 连续 的 请 求 中 ， 客 户 端 并 不 依赖 于 同一 台 
服务 器 。 一 个 客户 端 从 菜 台 服务 器 上 收 到 一 份 包 含 链接 的 文档 ， 当 它 要 做 一 些 
处 理 时 ， 这 台 服 务 器 宕 掉 了 ， 可 能 是 硬盘 坏 掉 而 被 拿 去 修理 ， 可 能 是 软件 需要 
升级 重启 如 果 这 个 客户 端 访问 了 从 这 台 服 务 器 接收 的 链接 ， 它 不 会 察觉 到 
后 台 的 服务 器 已 经 改变 了 。 通 过 超 链接 实现 有 状态 交互 ， 即 请 求 消息 是 自 包 含 
的 (每 次 交互 都 包含 完整 的 信息 ) ， 有 多 种 技术 实现 了 不 同 请 求 间 状态 信息 的 
传输 ， 例 如 URI 重新，cookies 和 隐藏 表单 字段 等 ， 状 态 可 以 谋 入 到 应 答 消息 
里 ， 这 样 一 来 状态 在 接 下 来 的 交互 中 仍然 有 效 。REST 风格 应 用 可 以 实现 交 
互 ， 但 它 却 天 然 地 具有 服务 器 无 状态 的 特征 。 在 状态 迁移 的 过 程 中 ， 服 务 器 不 
需要 记录 任何 Session， 所 有 的 状态 都 通过 URI 的 形式 记录 在 了 客户 端 ? 更 准 
确 地 说 ， 这 里 的 无 状态 服务 器 ， 是 指 服务 器 不 保存 会 话 状 态 (Session) ; 而 资源 
本 身 则 是 天 然 的 状态 ， 通 常 是 需要 被 保存 的 ; 这 里 所 指 无 状态 服务 器 均 指 无 会 
话 状 态 服 务 器 。 





HTTP 请 求 方法 在 RESTful Web 服务 中 的 典型 应 用 
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Java REST 


针对 REST 在 Java 中 的 规范 ， 主 要 是 JAX-RS (Java API for RESTful Web 
Services) ， 该 规范 使 得 Java 程序 员 可 以 使 用 一 套 固 定 的 接口 来 开发 REST 应 

用 ， 避 免 了 依赖 于 第 三 方 框架 。 同 时 ，JAX-RS 使 用 POJO 编程 模型 和 基于 标注 的 
配置 ， 并 集成 了 JAXB， 从 而 可 以 有 效 缩短 REST 应 用 的 开发 周期 。Java EE 6 引 
入 了 对 JSR-311 的 支持 ，Java EE 7 支持 JSR-339 规范 。 


JAX-RS 定义 的 API 位 于 javax.ws.rs 包 中 。 


伴随 着 JSR 311 规范 的 发 布 ，Sun 同步 发 布 该 规范 的 参考 实现 Jersey。JAX-RS 
的 具体 实现 第 三 方 还 包括 Apache 的 CXF 以 及 JBoss 的 RESTEasy 等 。 未 实现 该 
规范 的 其 他 REST 框架 还 包括 SpringMVC 等 。 


截至 目前 ，JAX-RS 最 新 的 版 本 是 2.0 (JSR-339) 


Why Jersey 


在 Java F > RA 规范 的 制定 者 和 实现 者 都 是 Sun 公司 (现在 是 Oracle) ,那么 
Jersey 毫 无 疑问 就 是 事实 上 的 标准 ， 对 于 Java REST 的 初学 者 来 说 尽量 要 跟着 标 
准 走 。 当 然 ， 所 有 规范 的 实现 ， 在 用 法 上 基本 上 没有 差别 ， 只 是 相对 来 说 Jersey 
的 实现 更 全 面 一 些 。 


本 书 所 有 的 例子 都 是 基于 Jersey 的 ， 有 关 Jersey 的 参考 ， 可 详 见 《Jersey 2.x 用 
户 指南 》。 


Getting Started 开始 


本 章 通过 简单 的 示例 带 你 快速 入 门 。 当 你 读 完 本 章节 ， 你 马上 就 可 以 用 Jersey 5 
出 Web 应 用 。 


Before Getting Started 开始 之 前 


因为 我 们 的 示例 都 是 通过 Maven 进行 管理 ， 所 谓 ， 在 开始 之 前 ， 假 设 你 已 经 具备 
Maven 的 基础 知识 。 如 果 你 是 Maven 新 手 ， 可 以 参 

% http://www.waylau.com/apache-maven-3-1-0-installation-deployment-and-use/ 
进行 Maven XX » &#http://www.waylau.com/build-java-project-with-maven/& 
it 2447 Maven AT] ° 


Requirements 需要 环境 


e JDK 7+ 
e Maven 3.2.x 


这 就 是 所 有 必需 的 环境 。 当 然 ， 你 可 以 根据 自己 的 喜好 选择 使 用 DE o ARAE 
0 Eclipse 4.4 ° 


First REST App 


在 工作 目录 ， 创 建 第 一 个 Maven 管理 的 应 用 ， 执 行 


mvn archetype:generate -DarchetypeArtifactId-jersey-quickstart-w 
ebapp -DarchetypeGroupId-org.glassfish.jersey.archetypes -Dinter 
activeMode-false -DgroupId-com.waylau -DartifactId=simple-servic 
e-webapp -Dpackage-com.waylau.rest -DarchetypeVersion-2.16 


项 目 打包 成 WAR, 执 行 


mvn clean package 


打包 成 功 后 ， 打 包 的 WAR (位 于 ./target/simple-service-webapp.war ) 可 
以 将 它 部 署 到 您 任意 的 Servlet 容器 ， 比 如 Tomcat、Jetty、JBoss 等 。 


« simple-service-webapp » target > v|*4|| FE; 


E Baw) 工具 中” 帮助 (H) 
DSE v HE > 新 建文 件 去 


"kspaceDW zi SER 
^k FBA7 

des d classes 
"kspaceGit 


| generated-sources 


"'kspaceGithub Jj maven-archiver 


ngulaJS-demos لان‎ simple-service-webapp 


radle-2-User-Guide |.) simple-service-webapp.war 


irsey-2x-User-Guide 


浏览 器 访问 该 项 目 


/ x 
k Ny © E http://localhost:8089/simple-service-webapp/ 


Bosne «fy 
Jersey RESTful Web Application! 








Visit Project Jersey website for more information on Jersey! 


i “Jersey resource”, 可 以 在 页 面 输出 资源 “Got it!” 





ter ) a http://localhost:8089/simple-service-webapp/webapi/myresource 
OR 
国 localhost i | | 


Got it! 











注意 : BH Jersey 项 目 ，Servlet 容器 版 本 应 该 是 不 低 于 2.5， 如 果 想 支持 更 高 的 特 
性 (比如 JAX-RS 2.0 Async Support) ，Servlet 容 器 版 本 应 该 是 不 低 于 3.0 


自 此 ， 第 一 个 REST 项 目 完成 。 


Source code 72.43 


JL simple-service-webapp ° 


Exploring the Newly Created Project 探索 
新 项 目 


simple-service-webapp 这 个 是 由 Jersey 提供 Maven archetype 用 来 创建 的 
web 项 目 ， 在 你 的 项 目 里 面 随意 调整 pom.xml 内 的 groupld， 包 号 和 版 本 号 就 可 以 
成 为 一 个 新 的 项 目 。 此 时 ，simple-service-webapp 已 经 创建 ， 符 合 Maven 的 项 目 
结构 : 


e 标准 的 管理 配置 文件 pom.xml 

e 源 文件 路 径 src/main/java 

e 资源 文件 路 径 src/main/resources 

e web 应 用 文件 src/main/webapp 
该 项 目 包 含 一 个 名 为 MyResouce 的 JAX-RS 资源 类 。 在 src/main/webapp/WEB- 
INF 下 ， 它 包含 了 标准 的 JavaEE Web 应 用 的 web.xml 部 署 描 述 符 。 项 目 中 的 最 后 
一 个 组 件 是 一 个 index.jsp 页 面 作为 这 次 MyResource 资源 类 打包 和 部 署 的 应 用 程 


MyResource 类 是 JAX-RS 的 一 个 实现 的 源 代 码 ， 如 下 : 


package com.waylau.rest; 


import javax.ws.rs.GET; 

import javax.ws.rs.Path; 

import javax.ws.rs.Produces; 
import javax.ws.rs.core.MediaType; 


JESSE 
* RRR (暴露 在 "myresource'" 路 径 ) 
= 

QPath("myresource") 

public class MyResource { 


/** 
* 方法 处 理 HTTP GET 请 求 。 返 回 的 对 象 以 "text/plain" 媒 体 类 型 
* HR p 
* return String 以 text/plain 形式 响应 
A 

QGET 

QProduces(MediaType.TEXT PLAIN) 

public String getlt() 1 

return "Got it!"; 


一 个 JAX-RS 资源 是 一 个 可 以 处 理 绑 定 了 资源 的 URI 的 HTTP 请 求 的 带 有 注解 的 
POJO。 在 我 们 的 例子 中 ， 单 一 的 资源 暴露 了 一 个 公开 的 方法 ， 能 够 处 理 HTTP 
GET R > MEE /myresource URI 路 径 下 ， 可 以 产生 媒体 类 型 为 “text/plain” 的 
响应 消息 。 在 这 个 示例 中 ， 资 源 返 回 相同 的 “Got ip 应 对 所 有 客户 端的 要 求 。 


Rapid Development 快速 开发 


为 了 快速 开发 ， 首 先是 需要 一 款 趁 手 的 IDE。 IDE 的 选取 以 个 人 喜好 为 主 ， 只 要 是 
自己 熟悉 的 就 好 。 本 书 的 实例 是 使 用 Eclipse 作为 IDE 。 


安装 M2Eclipse 插件 


Ds) 


一 般 Eclipse 都 集成 Maven 的 插件 ， 如 果 没 有 ， 要 想 在 Eclipse 中 使 用 Maven ’ 
要 安装 M2Eclipse 插件 。 有 关 M2Eclipse 的 安装 可 以 参 


考 http://www.eclipse.org/m2e/。 安 装 完 后 就 能 导入 Maven 项 目 ， 使 用 Maven 的 命 


令 行 。 
Sj Import Eem] 
Select 
T 3 
Import Existing Maven Projects [L4] 


Select an Import source: 


type filter text 





(& Java EE 
4 (> Maven 
kJ Check out Maven Projects from SCM 
MJ Existing Maven Projects 
G, Install or deploy an artifact to a Maven repository 
WJ, Materialize Maven Projects from SCM 
E Plug-in Development 
(> Remote Systems 
E Run/Debug 
( Tasks 
(= Team 
E Web 


CI TAA "Pn 


m 











® « Back Finish Cancel 


Run As > Æ] 1 Java Applet Alt-- Shift--X, A 
Team >| By 


2 Java Application Alt-- Shift--X, J 
EN 1 : 


Compare With 


Replace With 4 Maven build Alt+Shift+X, 
Restore from Local History... 5 Maven build... 





Maven 6 Maven clean 
Configure 7 Maven generate-sources 


Source 8 Maven install 


9 Maven test 


Properties 


wy > wx 

Awe Servlet KZ 

放 了 方便 运行 项 目 ， 可 以 将 Servlet 容器 内 入 进项 目 中 。 下 面谈 下 几 种 常见 的 
Servlet X Z WHA ° 

it A Tomcat 


设置 插件 


<plugin> 
<groupId>org.apache. tomcat .maven</groupId> 
<artifactId>tomcat7-maven-plugin</artifactId> 
<version>${tomcat7.version}</version> 
</plugin> 


mvn tomcat7:run 


{@} Edit Configuration 


Edit configuration and launch. 


Name: servlet-container 
E] Main ~ BA JRE | :Refresh | E> Source FE Environment C] Common 
Base directory: 


D:/workspaceGithub/rest-in-action/samples/servlet-container 





Goals: tomcat?:run 





Profiles: 
User settings: 


“| Offline || Update Snapshots 
|Debug Output | |Skip Tests Non-recursive 
Resolve Workspace artifacts 


a -J Threads 





Parameter Name ‘Value 





项 目 局 动 成 功 ， 可 以 看 到 输出 : 


[INFO] Scanning for projects... 
[INFO] 


5 





Browse Workspace.. | | Browse File System. | | Variables... 











[ Select... | 
CE 
| [ Ade...) 
| Apply | | Revert 
(ate 


[INFO] Using the builder org.apache.maven.lifecycle.internal.bui 
lder.singlethreaded.SingleThreadedBuilder with a thread count of 


1 
[INFO] 


[INFO] Building servlet-container 1.0-SNAPSHOT 
[INFO] --------------------------------------------------------- 


[INFO] 


[INFO] >>> tomcat7-maven-plugin:2.2:run (default-cli) @ servlet- 


container >>> 
[INFO] 


[INFO] --- maven-resources-plugin:2.6:resources (default-resourc 


es) @ servlet-container --- 


[INFO] Using 'UTF-8' encoding to copy filtered resources. 


[INFO] skip non existing resourceDirectory D:\workspaceGithub\re 
st-in-action\samples\servlet -container\src\main\resources 

[INFO] 

[INFO] --- maven-compiler-plugin:2.5.1:compile (default-compile) 
@ servlet-container --- 

[INFO] Compiling 1 source file to D:\workspaceGithub\rest-in-act 
ion\samples\servlet-container\target\classes 

[INFO] 

[INFO] <<< tomcat7-maven-plugin:2.2:run (default-cli) @ servlet- 
container <<< 

[INFO] 

[INFO] --- tomcat7-maven-plugin:2.2:run (default-cli) @ servlet- 
container --- 

[INFO] Running war on http://localhost :8080/servlet -container 
[INFO] Creating Tomcat server configuration at D:\workspaceGithu 
b\rest-in-action\samples\servlet-container\target\tomcat 

[INFO] create webapp with contextPath: /servlet-container 

—H 02, 2015 2:25:06 TF org.apache.coyote.AbstractProtocol ini 
t 

INFO: Initializing ProtocolHandler ["http-bio-8080"] 

—H 02, 2015 2:25:07 TF org.apache.catalina.core.StandardServi 
ce startInternal 

INFO: Starting service Tomcat 

=A 02, 2015 2:25:07 下 午 org.apache.catalina.core.StandardEngin 
e startInternal 

INFO: Starting Servlet Engine: Apache Tomcat/7.0.47 

—H 02, 2015 2:25:11 下 午 org.apache.coyote.AbstractProtocol sta 
rt 

INFO: Starting ProtocolHandler ["http-bio-8080" | 


在 浏览 器 里 访问 http://localhost:8080/servlet-container/ 就 能 看 到 主页 面 了 。 


Rapid Development 快速 开发 


http://localhos...let-container/ 


| ( € e http://localhost:8080/servlet-container/ 


Jersey RESTful Web Application! 








Jersey resource 


Visit www.waylau.com for more information on Jersey! 


ik A Jetty 


设置 插件 
<plugin> 
<groupId>org.eclipse.jetty</groupId> 
<artifactId>jetty-maven-plugin</artifactId> 


<version>${jetty.version}</version> 
</plugin> 


注意 : 使 用 该 插件 需要 Maven 3 和 Java 1.7 及 以 上 版 本 


mvn jetty:run 
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183 Edit Configuration 


Edit configuration and launch. 


Name: servlet-container (1) 





ES Main \ BA JRE | & Refresh ky Source | M Environment! 加 Common 
Base directory: 


D:/workspaceGithub/rest-in-action/samples/servlet-container 








Browse Workspace... | Browse File Syster. | | Variables.. | 




















Goals: jetty:run| | Select... | 
Profiles: 1 
User settings: | File... | | 

E Offline M] Update Snapshots 

Debug Output | |Skip Tests | Non-recursive 

[-]Resolve Workspace artifacts 

[i »] Threads 
[ Parameter Name — Value i | Add... | 

Edit... 
| Apply | | Revert | 


项 目 局 动 成 功 ， 可 以 看 到 输出 : 


[INFO] Scanning for projects... 
[INFO] 


[INFO] Using the builder org.apache.maven.lifecycle.internal.bui 
lder.singlethreaded.SingleThreadedBuilder with a thread count of 


1 
[INFO] 


PEN EO eee ee eee RE ES SER 


[INFO] 


[INFO] >>> jetty-maven-plugin:9.2.9.v20150224:run (default-cli) 


Q servlet-container >>> 
[INFO] 


[INFO] --- maven-resources-plugin:2.6:resources (default-resourc 


es) @ servlet-container --- 


[INFO] Using 'UTF-8' encoding to copy filtered resources. 


[INFO] skip non existing resourceDirectory D:\workspaceGithub\re 
st-in-actionNsamplesNservlet-containerNsrcNmainNresources 

[INFO] 

[INFO] --- maven-compiler-plugin:2.5.1:compile (default-compile) 
Q servlet-container --- 

[INFO] Nothing to compile - all classes are up to date 

[INFO] 

[INFO] --- maven-resources-plugin:2.6:testResources (default-tes 
tResources) Q servlet-container --- 

[INFO] Using 'UTF-8' encoding to copy filtered resources. 

[INFO] skip non existing resourceDirectory D:\workspaceGithub\re 
st-in-actionNsamplesNservlet-containerNsrcNtestNresources 

[INFO] 

[INFO] --- maven-compiler-plugin:2.5.1:testCompile (default-test 
Compile) Q servlet-container --- 

[INFO] No sources to compile 

[INFO] 

[INFO] ««« jetty-maven-plugin:9.2.9.v20150224:run (default-cli) 
Q servlet-container ««« 

[INFO] 

[INFO] --- jetty-maven-plugin:9.2.9.v20150224:run (default-cli) 
Q servlet-container --- 

2015-03-02 15:06:54.654:INFO::main: Logging initialized @1764ms 
[INFO] Configuring Jetty for project: servlet-container 

[INFO] webAppSourceDirectory not set. Trying src\main\webapp 
[INFO] Reload Mechanic: automatic 

[INFO] Classes = D:\workspaceGithub\rest-in-action\samples\servl 
et-container\target\classes 

[INFO] Context path = / 

[INFO] Tmp directory = D:\workspaceGithub\rest-in-action\samples 
\servlet-container\target\tmp 

[INFO] Web defaults = org/eclipse/jetty/webapp/webdefault. xml 
[INFO] Web overrides = none 

[INFO] web.xml file = file:/D:/workspaceGithub/rest-in-action/sa 
mples/servlet -container/src/main/webapp/WEB-INF/web. xml 

[INFO] Webapp directory = D:NworkspaceGithubNrest-in-actionNsamp 
lesNservlet-containerNsrcNmainNwebapp 

2015-03-02 15:06:54.713:INF0:0ejs.Server:main: jetty-9.2.9.v2015 
0224 

2015-03-02 15 : 06 : 55 . 885 : INFO:oejsh.ContextHandler:main: Started 


0.e€.j.m.p.JettywebAppContext@2863c{/, file:/D:/workspaceGithub/re 
st-in-action/samples/servlet-container/src/main/webapp/,AVAILABL 
E file:/D:/workspaceGithub/rest-in-action/samples/servlet-conta 
iner/src/main/webapp/ } 

2015-03-02 15:06:55.886:WARN:oejsh.RequestLogHandler:main: !Requ 
estLog 

[INFO] Started Jetty Server 

2015-03-02 15:06:55.911:INF0:06ejs.ServerConnector:main: Started 
ServerConnector@1dde93{HTTP/1.1}{0.0.0.0:8080} 

2015-03-02 15 : 06 : 55 . 912 : INFO:oejs.Server:main: Started @3022ms 


在 浏览 器 里 访问 http:/Wlocalhost:8080 就 能 看 到 主页 面 了 。 这 里 Jetty 启动 项 目 是 默 
认 是 不 显示 项 目 名 称 的 。 





http://localhost:8080/ Y + 





€ http://localhost:8080 


Jersey RESTful Web Application! 


Jersey resource 


Visit www. waylau.com for more information on Jersey! 


Source code 75 


Jh servlet-container ° 


参考 : 


e http://www.eclipse.org/jetty/documentation/current/jetty-maven-plugin.html 
e http://tomcat.apache.org/maven-plugin.html 
e Tomcat Maven Plugin 使 用 http://www.waylau.com/tomcat-maven-plugin/ 


Custom ResourceConfig 自 定义 资源 配置 


IK web.xml 
之 前 的 Web.xml 配置 是 这 样 的 : 


«web-app version="2.5" xmins="http://java.sun.com/xml/ns/javaee" 
xmlns:xsi-'http://www.w3.0rg/2001/XMLSchema-instance" xsi:schem 
aLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com 
/xml/ns/javaee/web-app 2 5.xsd'» 
<servlet> 
<servlet-name>Jersey Web Application</servlet -name> 
<servlet-class>org.glassfish.jersey.servlet.ServletConta 
iner</servlet-class> 
<init -param> 
<param-name>jersey.config.server.provider .packages</ 
param-name> 
<param-value>com.waylau.rest</param-value> 
</init-param> 
<load-on-startup>1</load-on-startup> 
</servlet> 
<servlet -mapping> 
<servlet-name>Jersey Web Application</servlet -name> 
<url-pattern>/webapi/*</url-pattern> 
</servlet -mapping> 
</web-app> 


其 中 


<init-param> 
<param-name>jersey.config.server.provider.packages</param-na 
me> 
<param-value>com.waylau.rest</param-value> 
</init-param> 


这 段 说 的 是 ， 如 果 配 置 属性 无 需 设 置 ， 要 部 署 应 用 程序 只 包括 存储 在 特定 的 包 的 资 
源 和 提供 者 ， 那 么 你 可 以 指示 Jersey 自动 扫描 这 些 包 ， 这 样 就 能 自动 注册 找到 的 

任何 资源 和 提供 者 ,这 样 就 能 找到 了 com.waylau.rest 包 下 的 MyResource 资源 
并 且 注 册 。 


自 定义 配置 

当 需 要 更 多 的 配置 ， 上 述 方法 显然 不 能 满足 。 可 以 重 写 Application 类 。 
package com.waylau.rest; 
import org.glassfish.jersey.server.ResourceConfig; 


[tsi 
* REST 主 应 用 


* 


* @author waylau.com 
* 2015523 8 
2 
public class RestApplication extends ResourceConfig { 


public RestApplication() { 
// 资 源 类 所 在 的 包 路 径 
packages("com.waylau.rest"); 


为 了 规范 ， 我 们 在 建立 com.waylau.rest.resource 包 ， 用 来 专门 放 资 源 来 。 
接着 把 我 们 的 资源 MyResource 移 到 该 包 下 面 。 


public class RestApplication extends ResourceConfig f 
public RestApplication() { 


// 资 源 类 所 在 的 包 路 径 
packages("com.waylau.rest.resource"); 


3x > RestApplication 在 web.xml 配置 是 这 样 的 : 
<init-param> 
<param-name>javax.ws.rs.Application</param-name> 
<param-value>com.waylau.rest.RestApplication</param-value> 
</init-param> 
v= A- N * Ys 
运行 测试 


启动 项 目 ， 访 问 http://localhost:8080/, & “Jersey resource”， 显 示 “Got it!” > 3658] 
配置 成 功 。 


源码 


见 custom-resourceconfig 项 目 


Handle JSON and XML 处 理 JSON 和 XML 


一 个 POJO 对 办 


为 了 项 目 更 加 清晰 ， 我 们 建立 com.waylau.rest.bean ,在 该 包 下 面 创建 一 个 
POJO *t % MyBean : 


public class MyBean ( 


private String name; 
private int age; 


public String getName() ( 
return name; 

} 

public void setName(String name) { 
this.name = name; 

} 

public int getAge() ( 
return age; 

} 

public void setAge(int age) { 
this.age = age; 


JSON 处 理 


我 们 想 把 这 个 对 象 返回 给 客户 端 ， 在 MyResource 资源 下 ， 写 了 


/** 
* 方法 处 理 HTTP GET 请 求 。 返 回 的 对 象 以 "application/json" 媒 体 类 型 
* ARP ak 
* 

* (return MyPojo 以 application/json 形式 响应 
HA 

@GET 

QPath("pojojson") 

QProduces(MediaType.APPLICATION JSON) 

public MyBean getPojoJson() { 

MyBean pojo - new MyBean(); 
pojo.setName("waylau.com"); 
pojo.setAge(28); 

return pojo; 


其 中 @Produces(MediaType.APPLICATION_XML) 意思 是 以 JSON 形式 将 对 象 返 
回 给 客户 端 。 


在 index.jsp 里 面 ， 我 们 写 了 一 个 调用 该 API 的 方法 


<p><a href="webapi/myresource/pojojson">P0JO JSON</a> 


JA HRA &aPOJO JSON”, 后 台 提 示 如 下 错误 


org.glassfish.jersey.message.internal.WriterInterceptorExecutor$ 
TerminalWriterInterceptor aroundwriteTo 

SEVERE: MessageBodyWriter not found for media type=application/j 
son, type=class com.waylau.rest.bean.MyPojo, genericType=class c 
om.waylau.rest.bean.MyPojo. 


那 是 因为 POJO 对 象 未 被 序列 化 成 JSON 对 象 ， 所 以 找 不 到 ， 下 面 介 绍 几 种 常用 
的 序列 化 手段 。 


采用 MOXy 


需要 添加 jersey-media-moxy 依赖 库 在 你 的 pom.xml 来 使 用 MOXy 


<dependency> 
<groupId>org.glassfish.jersey.media</groupId> 
<artifactId>jersey-media-moxy</artifactId> 
</dependency> 


由 于 JSON 绑 定 特性 是 在 自动 发 现 的 列表 里 ， 所 以 无 需 再 注册 该 特性 就 使 用 了 。 
(关于 “自动 发 现 "， 详 见 《Jersey 2.x 用 户 指南 》“4.3. 自 动 发 现 的 特性 "一 节 ) 


启动 项 目 ， 点 击 “POJO JSON” ,页面 输 出 


{"age":28, "name": "waylau.com"} 





1 http://localho...urce/pojojson b as 





€ http://localhost:8080/webapi/myresource/pojojson 


n‏ وير 


a a” a” و‎ 
l'age" :28, "name" : waylau. com”] 


ÅH Jackson (2.x) 


使 用 Jackson 2.x 需 添 加 jersey-media-json-jackson 模块 到 pom.xml: 


<dependency> 
<groupId>org.glassfish.jersey.media</groupId> 
<artifactId>jersey-media-json-jackson</artifactId> 
</dependency> 


XML 处 理 


我 们 想 把 这 个 对 象 返 回 给 客户 端 ， 在 MyResource 资源 下 ， 写 了 


/** 
* 方法 处 理 HTTP GET 请 求 。 返 回 的 对 象 以 "application/xml" 媒 体 类 型 
* ARP ak 
* 

* (return MyPojo 以 application/xml 形式 响应 
HA 

@GET 

@Path("pojoxml" ) 

QProduces(MediaType.APPLICATION XML) 

public MyBean getPojoXml() { 

MyBean pojo - new MyBean(); 
pojo.setName("waylau.com"); 
pojo.setAge(28); 

return pojo; 


其 中 QProduces(MediaType.APPLICATION XML) 意思 是 以 XML 形式 将 对 象 返回 
给 客户 端 


在 index.jsp 里 面 ， 我 们 写 了 一 个 调用 该 API 的 方法 


<p><a href="webapi/myresource/pojoxml">P0JO XML</a> 


局 动 项 目 ， 点 击 "POJO XML”, 后 台 提 示 如 下 错误 


org.glassfish.jersey.message.internal.WriterInterceptorExecutor$ 
TerminalWriterInterceptor aroundwriteTo 

SEVERE: MessageBodyWriter not found for media type-application/x 
ml, type=class com.waylau.rest.bean.MyPojo, genericType-class co 
m.waylau.rest.bean.MyPojo. 


那 是 因为 POJO 对 象 未 被 序列 化 成 XML 对 象 ， 所 以 找 不 到 ， 解 决 方法 很 简单 ， 在 
MyBean 上 面 加 上 @XmlRootElement 注解 即 可 


Handle JSON and XML 222 JSON 和 XML 


QXmlRootElement 
public class MyBean { 


private String name; 
private int age; 


public String getName() ( 
return name; 

} 

public void setName(String name) { 
this.name = name; 

} 

public int getAge() { 
return age; 

} 

public void setAge(int age) { 
this.age = age; 


(QXmlRootElement 作用 是 将 一 个 类 或 一 个 枚 举 类 型 映射 为 一 个 XML 元素。 


再 次 启动 项 目 ， 点 击 "POJO XML”, 显 示 正 常 


http://localho...ource/pojoxml 





€ | & http:/localhost:8080/webapi/myresource/pojoxml 


ست 


该 MIL 文件 并 未 包含 任何 天 联 的 样式 信息 。 文 档 树 显示 如 下 。 





— <myBean> 
<age>28</age> 
<name>waylau. com</name> 
</myBean> 


7$ 8B 


JL handle-json-xml 项 目 。 
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Handle JSON and XML 232 JSON 和 XML 


29 


Encoding Format X #2 75 43 I>] i 


中 文 乱码 


一 般 的 ， 我 们 都 会 将 项 目 和 代码 设置 为 UTF-8 编码 格式 ， 但 有 时 候 还 远 远 不 够 。 
我 们 在 ”handle-json-xml 项 目的 基础 上 ， 进 行 修改 成 为 另外 一 个 新 项 目 。 


将 MyResource.java 改 为 如 下 


QPath("myresource") 
public class MyResource { 


[Pers 
* 方法 处 理 HTTP GET 请 求 。 返 回 的 对 象 以 "text/Vp1lain'" 媒 体 类 型 
* 给 客户 端 
* 
* Qreturn String 以 text/plain 形式 响应 
Bee 
@GET 
@Produces(MediaType. TEXT PLAIN) 
public String getIt() 1 
return "Got it!"; 


/** 
* 方法 处 理 HTTP GET Re Ami" application/xml" KA 
* 给 客户 端 
* @return MyPojo 以 application/xml 形式 响应 
A 

@GET 

QPath("pojoxml") 

QProduces(MediaType.APPLICATION XML) 

public MyBean getPojoXml() { 

MyBean pojo - new MyBean(); 
pojo.setName(" 3x3? Śl% : waylau.com"); 


Encoding Format 处 理 编码 问题 


pojo.setAge(28); 
return pojo; 


/** 
* 方法 处 理 HTTP GET 请 求 。 返 回 的 对 象 以 "app1ication/json" 媒 体 类 型 
* 给 客户 端 
* 

* @return MyPojo 以 application/json 形式 响应 
» 

QGET 

QPath("pojojson") 

QProduces(MediaType.APPLICATION JSON) 

public MyBean getPojoJson() 1 

MyBean pojo - new MyBean(); 
pojo.setName(" 欢 迎 光 临 : waylau.com"); 
pojo.setAge(28); 

return pojo; 


启动 项 目 ， 访 问 浏 览 器 http://localhost:8080/ > ;&:43"POJO JSON” X# “POJO 
XML”， 显 示 如 下 ， 中 文 已 乱 。 


http://localho...urce/pojojson X 


( ) & | localhost:8080/webapi/myresource/pojojson 


l'age" :28, "name" : “$8322 8 if Fay lau. com”) 





问题 解决 


在 返回 的 数据 里 面 ， 我 们 设置 编码 格式 charset=utf-8 ,关键 代码 如 下 : 


31 


private final static String CHARSET UTF 8 = "charset=utf-8"; 


@GET 
@Path("pojoxml" ) 
@Produces(MediaType.APPLICATION_XML + ";" + CHARSET UTF 8) 
public MyBean getPojoXml() { 
MyBean pojo - new MyBean(); 
pojo.setName(" c3? Śl% : waylau.com"); 
pojo.setAge(28); 
return pojo; 


@GET 
QPath("pojojson") 
QProduces(MediaType.APPLICATION JSON + ";" + CHARSET UTF 8) 
public MyBean getPojoJson() { 
MyBean pojo - new MyBean(); 
pojo.setName(" c3? كات‎ : waylau.com"); 
pojo.setAge(28); 
return pojo; 


再 次 访问 浏览 器 ， 查 看 到 所 有 的 中 文 显示 都 正常 了 。 


[4 





| http;//localho..urce/pojojson X 1 T 


»© 1 localhost:8080/webapi/myresource/pojojson 


l'age" :28, "name" :欢迎 光临 ，wavlau. com”) 








使 用 Java SE 部 署 环境 


上 面 几 个 例子 ， 我 们 是 使 用 了 内 上 葡 的 Tomcat 或 者 Jetty 的 服务 器 形式 ， 用 来 运行 
和 测 斌 项目。 最终， 项 目 也 会 打包 成 WAR 部 署 在 Tomcat 或 者 Jetty 等 Servlet 容 
器 中 。 这 种 部 署 形式 被 称 为 基于 Servlet 的 部 署 ( Servlet-based Deployment) ° 
这 种 部 署 环境 也 是 最 广泛 使 用 的 。 


有 时 ， 我 们 会 有 这 样 的 需求 ， 当 Web 应 用 不 是 很 复杂 ， 对 应 用 性 能 要 求 不 是 很 高 

时 ， 需 要 将 Http Server Nake 48,1119 Java 程序 中 ， 只 要 运行 Java 程序 ， 相 应 的 
Http Server 也 就 跟着 启动 了 ， 而 且 启 动 速 度 很 快 。 这 就 是 本 文 所 介绍 的 基于 Java 
SE 部 署 环境 (Java SE Deployment) 来 提供 REST 服务 。 


izg 
Q 


0 


HTTP 服务 


89 


基于 Java 的 HTTP 服务 器 展现 了 一 种 简约 、 — Jersey 应 用 程序 的 方式 。 
HTTP 服务 器 通常 是 诅 入 在 应 用 程序 中 ， 并 通过 配置 ,以 编程 形式 来 启动 。 et 
说 ,Jersey 容器 为 特定 的 HTTP 服务 器 提供 了 一 人 ban mk oe 用 来 返 

个 正确 初始 化 的 HTTP 服务 器 实例 。 


下 面 展示 了 常见 HTTP 服务 器 的 内 散在 Jersey 应 用 中 的 使 用 方法 : 


JDK Http Server 


从 Java SE 6 开始 ,Java 运行 时 附带 一 个 内 置 的 轻 量 级 的 HTTP 服务 器 。Jersey 通 
过 jersey-container-jdk-http 容器 扩展 模块 ， 提 供 集 成 这 个 Java SE HTTP 服务 

器 。 此 时 ， 不 是 直接 创建 HttpServer 实例 ,而 是 使 用 JdkHttpServerFactory 的 
createHttpServer() 方 法 , 它 根据 Jersey 容器 配置 和 Application 子 类 提供 的 初始 化 
来 创建 HttpServer 实例 。 


创建 一 个 Atk Jersey 的 jdk http server 非常 简单 : 


Jersey 和 JDK HTTP Server 用 法 : 


URI baseUri = UriBuilder.fromUri("http://localhost/").port(9998) 
.build(); 

ResourceConfig config - new ResourceConfig(MyResource.class); 
HttpServer server - JdkHttpServerFactory.createHttpServer(baseUr 
i, config); 


JDK HTTP 容器 依赖 : 


<dependency> 
«groupId»org.glassfish.jersey.containers«/groupId» 
<artifactId>jersey-container -jdk-http</artifactId> 
<version>2.21</version> 

</dependency> 


Grizzly HTTP Server 


Grizzly 是 一 个 建立 在 Java NIO 之 上 的 支持 多 协议 的 框架 。Grizzly 由 在 简化 强大 的 
和 可 扩展 的 服务 器 开发 。Jersey 提供 了 一 个 容器 的 扩展 模块 ， 可 以 使 用 Grizzly 作 
为 运行 JAX-RS 应 用 普通 的 HTTP 容器 支持 。 从 Grizzly 服务 器 运行 JAX-RS 或 
Jersey 的 应 用 是 一 种 最 轻 量 和 最 容易 的 方法 ， 用 来 展现 RESTful 服务 。 


Grizzly 容器 支持 HTTP 注射 Grizzly 的 特性 

org.glassfish.grizzly.http.server.Request 和 

org.glassfish.grizzly.http.server.Response 实例 到 JAX-RS 和 Jersey 应 用 资源 和 供 

应 者 。 然 而 ， 由 于 Grizzly 的 Request 是 非 代理 性 的 ，Grizzly Request 的 注入 到 单 

例 (默认 ) 的 JAX-RS /和 Jersey 提供 者 只 可 能 通过 javax.inject.Provider 实例 。 
(Grizzly Response 22 & IF] ## 89 TRU] © ( 


Jersey fe Grizzly HTTP Server 用 法 : 


URI baseUri - UriBuilder.fromUri("http://localhost/").port(9998) 
.build(); 

ResourceConfig config - new ResourceConfig(MyResource.class); 
HttpServer server - GrizzlyHttpServerFactory.createHttpServer(ba 
seUri, config); 


容器 扩展 模块 依赖 要 加 入 : 


<dependency> 
«groupId»org.glassfish.jersey.containers«/groupId» 
<artifactId>jersey-container -grizzly2-http</artifactId> 
<version>2.21</version> 

</dependency> 


注意 : 通过 测试 框架 ，Jersey 使 用 Grizzly 已 经 广泛 的 在 项 目 单元 和 端 到 端 进行 了 


测 TÅ E 


Simple 服务 器 

Simple 是 一 个 框架 允许 开发 者 创建 HTTP 服务 器 ， 并 褒 入 到 应 用 中 。 同 样 的 ， 通 
过 从 jersey-container-simple-http 容器 扩展 模块 调用 工厂 方法 实现 创建 服务 器 实 
例 0 


Simple 的 框架 支持 HTTP 容器 注入 Simple 框架 特性 的 
org.simpleframework.http.Request 和 org.simpleframework.http.Response 实例 到 
JAX-RS 和 Jersey 应 用 资源 和 供应 者 。 


Jersey 和 Simple 框架 用 法 : 


URI baseUri = UriBuilder.fromUri("http://localhost/").port(9998) 
.build(); 

ResourceConfig config - new ResourceConfig(MyResource.class); 
SimpleContainer server - SimpleContainerFactory.create(baseUri, 
config); 


容器 扩展 模块 依赖 要 加 入 : 


<dependency> 
«groupId»org.glassfish.jersey.containers«/groupId» 
<artifactId>jersey-container -simple-http</artifactId> 
<version>2.21</version> 

</dependency> 


注意 : Simple HTTP 容器 不 支持 部 署 在 除了 根 路 径 是 ("1") 以 外 的 上 下 文 路 径 。 非 根 
路 径 的 上 下 文 路 径 在 部 署 中 是 被 忽略 的 。 


Jetty HTTP Server 


Jetty 是 流行 的 Servlet 容器 和 HTTP 服务器。 在 此 我 们 不 深究 Jetty 作为 Servlet 

容器 的 能 力 (尽管 我 们 在 我 们 的 测试 和 实例 使 用 它 ) ， 因 为 作为 基于 Servlet 部 署 
模型 并 没有 什么 特别 ， 具 体会 在 第 4.7 节 ，“ 基 于 Servlet 部 署 "部 分 进行 描述 。 我 们 
将 在 这 里 只 重点 描述 如 何 使 用 Jetty 的 HTTP 服务 器 。 


Jetty HTTP 容器 支持 注入 Jetty 444 4 org.eclipse.jetty.server.Request 和 
org.eclipse.jetty.server.Response 实例 到 JAX-RS 和 Jersey 应 用 资源 和 供应 者 。 
然而 ， 由 于 Jetty HTTP Request 是 非 代 理性 的 ，Jetty Request 4) 7E A 8] 2H] ) 
ik) 的 JAX-RS /和 Jersey 提供 者 只 可 能 通过 javax.inject.Provider 实例 。 (Jetty 
Response 会 遭受 同样 的 限制 。) 


Jersey 和 Jetty HTTP Server 用 法 : 


URI baseUri = UriBuilder.fromUri("http://localhost/").port(9998) 
.build(); 

ResourceConfig config - new ResourceConfig(MyResource.class); 
Server server - JettyHttpContainerFactory.createServer(baseUri, 
config); 


容器 扩展 模块 依赖 要 加 入 ( 译 者 注 : 原文 中 依赖 包 有 误 ， 这 里 做 了 更 正 ) : 


<dependency> 
«groupId»org.glassfish.jersey.containers«/groupId» 
«artifactId»jersey-container-jetty-http«/artifactId» 
<version>2.21</version> 

</dependency> 


注意 : Jetty HTTP 容器 不 支持 部 署 在 除了 根 路 径 是 ("/") 以 外 的 上 下 文 路 径 。 非 根 路 
径 的 上 下 文 路 径 在 部 署 中 是 被 忽略 的 。 


构建 REST 程序 


回顾 之 前 的 内 容 ， 从 《处 理 JSON 和 XML》 的 源 代 码 ， 我 们 进行 了 修改 : 


实体 


MyBean.java 


QXmlRootElement 
public class MyBean { 


private String name; 
private int age; 


public String getName() { 
return name; 

} 

public void setName(String name) { 
this.name = name; 

} 

public int getAge() { 
return age; 

} 

public void setAge(int age) { 
this.age = age; 


MyBean 作为 我 们 数据 相应 的 实体 。 


wip 8 
MyResource.java 


QPath("myresource") 
public class MyResource { 


V ARE 
* 方法 处 理 HTTP GET 请 求 。 返 回 的 对 象 以 "text/plain" 媒 体 类 型 


* 给 客户 端 


* 


* @return String 以 text/plain 形式 响应 
[7 
@GET 
@Produces(MediaType. TEXT PLAIN) 
public String getit() 1 
return "Got it!"; 


/** 
* 方法 处 理 HTTP GET 请 求 。 返 回 的 对 象 以 "application/xml" 媒 体 类 型 
* AP d 
* 

* (return MyPojo 以 application/xml 形式 响应 
7 

@GET 

@Path("pojoxml") 

QProduces(MediaType.APPLICATION XML) 

public MyBean getPojoXml() { 

MyBean pojo - new MyBean(); 
pojo.setName("waylau.com"); 
pojo.setAge(28); 

return pojo; 


/** 
* 方法 处 理 HTTP GET 请 求 。 返 回 的 对 象 以 "application/json" 媒 体 类 型 
* A d 
* 

* (return MyPojo 以 application/json 形式 响应 
“A 

@GET 

QPath("pojojson") 

QProduces(MediaType.APPLICATION JSON) 
public MyBean getPojoJson() { 

MyBean pojo - new MyBean(); 
pojo.setName( "waylau.com"); 
pojo.setAge(28); 

return pojo; 


分 别 向 外 暴露 各 种 类 型 资源 ， 包 括 : AX > XML > ISON 


应 用 配置 
RestApplication.java 
public class RestApplication extends ResourceConfig { 
public RestApplication() { 
// 资源 类 所 在 的 包 路 径 


ackages("com.waylau.rest.resource"); 
, 


// 注册 MultiPart 
register(MultiPartFeature.class); 


该 配置 说 明了 要 扫描 的 资源 包 的 路 径 com.waylau.rest.resource ， 以 及 支持 
JSON 转换 MultiPartFeature 


主 应 用 


App.java 


public class App { 

// HTTP server 所 要 监听 的 Uri 

public static final String BASE URI = "http://192.168.11.125 
:8081/"; 


joe 
* Main method. 
* 
* @param args 
* @throws IOException 
Ss 
public static void main(String[] args) throws IOException { 


// 若 使 用 Jdk Http Server 请 去 掉 下 面 的 注释 

// JdkHttpServerFactory.createHttpServer(URI.create(BASE 
_URI), new 

// RestApplication()); 


// 若 使 用 Grizzly Http Server 请 去 掉 下 面 的 注释 

// GrizzlyHttpServerFactory.createHttpServer(URI.create( 
BASE URI), new 

// RestApplication()); 


// 若 使 用 Simple Http Server 请 去 掉 下 面 的 注释 
// SimpleContainerFactory.create(URI.create(BASE URI), n 


ew 

// RestApplication()); 

// €1&H Jetty Http Server 请 去 掉 下 面 的 注释 

JettyHttpContainerFactory.createServer(URI.create(BASE U 
RI), 

new RestApplication()); 
j 

j 


各 种 服务 器 的 用 法 在 上 面 已 经 说 了 ， 这 里 就 不 再 解析 。 


源码 


Java SE Deployment Environments 使 用 Java SE 部 署 环境 


JL javase-rest "AH 


参考 : 


e Jersey 2.x 用 户 指南 
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Simulation of CURD 模拟 CURD 操 作 


下 面 ， 我 们 要 尝试 下 管理 系统 中 最 常用 的 几 个 CURD 操作 ， 来 模拟 一 个 “用 户 管 
JẸ” o 


服务 端 
在 服务 端 ， 我 们 要 提供 REST 风格 的 API 。 


UserBean 


先 创建 一 个 用 户 对 象 UserBean java 


QXmlRootElement 
public class UserBean { 


private int userId; 
private String name; 
private int age; 


public int getUserId() { 
return userId; 


public void setUserId(int userId) { 
this.userId = userId; 


public String getName() ( 
return name; 


public void setName(String name) { 
this.name = name; 


public int getAge() { 
return age; 


public void setAge(int age) { 
this.age = age; 


UserResource 


新 建 一 个 资源 类 UserResource.java ° 7» @Path("users") 注解 用 来 说 明 资源 根 
路 径 


是 users 


添加 


private static Map<Integer,UserBean> userMap = new HashMap<Inte 
ger, USerBean>(); 


用 来 在 内 存 中 存储 数据 。 可 以 在 userMap 获取 我 们 想 要 查询 的 数据 。 


完整 的 代码 如 下 : 


QPath("users") 
public class UserResource { 


private static Map<Integer,UserBean> userMap = new HashMap< 
Integer, UserBean>(); 
fe * 
* 增加 
* @param user 
= 
@POST 
QConsumes (MediaType.APPLICATION JSON) 
public List<UserBean> createUser(UserBean user) 
f 
userMap.put(user.getUserId(), user ); 
return getAllUsers(); 


/** 
* 删除 
* (param id 
HA 
@DELETE 
@Path("{id}") 
public List<UserBean> deleteUser(@PathParam("id")int id){ 
userMap.remove(id); 
return getAllUsers(); 


* (param user 
37 


@PUT 

QConsumes (MediaType.APPLICATION JSON) 

public List«UserBean» updateUser(UserBean user)( 
userMap.put(user.getUserId(), user ); 
return getAllUsers(); 


/** 
* 根据 Id 查询 
* @param id 
* @return 
27 
@GET 
@Path("{id}") 
@Produces (MediaType .APPLICATION_JSON) 
public UserBean getUserById(QPathParam("id") int id){ 
UserBean u = userMap.get(id); 
return u; 


/** 
* 查询 所 有 
* @return 
E 
@GET 
QProduces(MediaType.APPLICATION JSON) 
public List<UserBean> getAllUsers(){ 
List<UserBean> users = new ArrayList<UserBean>(); 
users.addAll( userMap.values() ); 
return users; 


为 了 简单 起 见 ， 我 们 约定 POST REAM HI > PUT 用 来 做 修改 ，DELETE Ml 
M GET 就 是 查询 ٠ 


自 此 ， 服 务 端 接口 开发 完毕 。 


ZP ii 


为 了 快速 测试 接口 ， 可 以 用 第 三 方 REST 客户 端 测试 程序 ， 我 这 里 用 的 


RESTClient 插件 ， 可 以 在 火狐 中 安装 使 用 。 
增加 用 户 


我 们 先 增加 一 个 用 户 对 象 ， 使 用 ISON 格式 


"userId": 1, 
"age": 28, 
"name": "waylau.com" 


提示 报错 : 415 未 支持 媒体 格式 的 错误 。 











http://localho…urce/pojøjson X y ER RESTclient x ١ + 
chrome:/frestclient/content/restclient.html g-ce 
File Authentication Headers View 
Method POST v URL http:/localhost:8080/webapi/users 
Body 


f"userld":001 ,"age":28,"name":"waylau.com"} 





[&]- Be «ce 


Response Headers Response Body (Raw) Response Body (Highlight) Response Body (Preview) 
Status Code 415 Unsupported Media Type 
Cache-Control must-revalidate,no-cache,no-store 
Content-Length 322 
Content-Type text/html; charset-I30-8859-1 
Date Tue, 03 Mar 2015 08:38:36 GMT 
Server Jetty(9.2.9.v20150224) 


由 于 我 们 在 新 增 的 接口 里 面 设 置 的 是 


QConsumes(MediaType. APPLICATION. JSON) 


RRS ©‏ م 


Favorite Requests 


© +i 


RESTClient 


sv EIN 


规定 只 接收 ISON 格式 ， 而 默认 的 “Conten-Type” 是 "text/html" 所 以 在 还 需要 在 


header 里 设置 一 下 为 “application/json”: 


Simulation of CURD 模拟 CURD 操 作 


Request Header 


Name 


x 


Value 


Save to favorite 


就 可 以 了 。 我 们 在 添加 一 个 用 户 对 象 


{ 

"userId": 2, 

"age": 24, 

"name": "www.waylau.com" 
} 


响应 的 数据 里 面 就 能 看 到 我 们 的 添加 的 用 户 了 。 


| Cancel 
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Simulation of CURD 模拟 CURD 操 作 





[-] Request 
wm ES ML 
Headers T Remove All 














[-] Response 








Response Headers | Response Body (Raw) [ERE nonse a aS Response Body (Preview) 


QI‏ $5 رت ب نا صا 


<?xml version="1.0" encoding-"UTF-8" standalone="yes" ?> 
<userBeans> 
<userBean> 
Xage»28«/age» 
<name>waylau. com< /name> 
<userId1</userId> 
</userBean> 
<userBean> 
<age>24< /age> 
<nane>www.waylau. com /name> 
<userId>2</userId> 
</userBean> 
</userBeans> 


修改 用 户 


修改 用 户 1 的 数据 : 


"userId"* 1, 
"age": 24, 
"name": " 小 柳 哥 " 


用 PUT 请 求 : 
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Method PUT v URL http://localhost:8080Avebapi/users 


Headers 


Content-Type: applicationjson > 


Body 


{ "userld": 1, "age": 24, "name": "!لتحا"‎ 


[~] Response 


Response Headers Response Body (Raw) Response Body (Highlight) Response Body (Preview) 


xml version-"1.0" encoding-"UTF-8" standalone="yes" 
<userBeans> 
<userBean> 
<age>24</age> 
<mname> 小 柳 哥 < /name> 
<userId>1l</userId> 
</userBean> 
<userBean> 
Xage»24«/age» 
Xname»www.waylau.conc/name? 
«userId»2«4/userId» 
</userBean> 
</userBeans> 


在 返回 的 数据 里 面 可 以 看 到 用 户 1 被 修改 


查询 用 户 
在 根据 ID 查询 的 接口 里 面 


@GET 
@Path("{id}") 


QProduces(MediaType.APPLICATION JSON) 
public UserBean getUserById(QPathParam("id") int id){ 
UserBean u = userMap.get(id); 


return u; 


* wv 


Eb 


SEND 


@Path("{id}") 15 id 这 个 子路 径 是 一 个 变量 。 我 们 查询 用 户 1 时 ， 要 将 用 户 1 的 
userld 放 在 请 求 的 URI 里 面 http://localhost:8080/webapi/users/1 


Simulation of CURD 模拟 CURD 操 作 





Headers TË Remove All 




















("age":28,"name":"waylau.com","userId":1) 





M ERA P 


与 上 面 类 似 ， 也 是 用 到 了 @Path("{id}") 


LI م‎ enon 








Headers T Remove all 











[-] Response 


Response Body (Highlight) 





<?xml version-"1.0" encoding-"UTF-8" standalone-"yes"?- 
<userBeans> 
<userBean> 
«age»28«/age» 
«name»www.waylau.com«/name» 
<userId>2</userId> 
</userBean> 
</userBeans> 


i 
3: 
4. 
5, 
5. 
8. 


我 们 看 到 用 户 1 被 删除 了 。 


自 此 整个 应 用 完成 了 。 这 个 “用 户 管理 " 够 简单 吧 ~ 


75 8B 
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Simulation of CURD 模拟 CURD 操 作 


XL simulation-curd ° 
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Parameter Annotations 常用 参数 注解 


在 前 面 的 章节 中 ， 我 们 已 经 了 解 了 几 个 参数 注解 ， 比 如 通过 @PathParam 来 获取 
URL 请 求 中 的 路 径 参 数 。 


@QueryParam 


@QueryParam 用 于 从 请 求 URL 的 查询 组 件 中 提取 查询 参数 。 我 们 在 MyResource 
里 面 添 加 下 面 的 方法 : 


@PUT 
QPath("pojo") 
QConsumes (MediaType.APPLICATION JSON) 
QProduces(MediaType.APPLICATION JSON) 
public MyBean putPojo(@QueryParam("age") int age, 
@QueryParam("name") String name) { 
MyBean pojo = new MyBean(); 
pojo.setName(name); 
pojo.setAge(age); 
return pojo; 


这 个 PUT 方法 ， 将 会 接收 从 URL 传递 过 来 的 参数 age,name ， 而 后 将 这 些 参 数 赋 
给 对 象 MyBean ， 并 且 返 回 。 


启动 服务 ， 在 RESTClient 里 面 发 送 PUT HR 
http://localhost:8080/webapi/myresource/pojo?age=28&name=waylau 。 成 功 后 就 
能 接收 到 一 个 JSON 数据 对 象 。 


"age": 28, 
"name": "waylau" 


Method PUT v URL httplocalhost8080/webapi/myresource/pojo?age=28 &name=waylau xv | SEND | 
Headers 
Content-Type: application/json > 
Body 
Request Body 
Response Headers Response Body (Raw) Response Body (Highlight) Response Body (Preview! 
E. 
d. 'age": 2 
d "name" "waylau" 
4. 


@DefaultValue 


如 果 需 要 为 参数 设置 默认 值 ， 可 以 使 用 @DefaultValue， 如 : 


我 们 在 MyResource 里 面 添加 下 面 的 方法 : 


@POST 
QPath("pojo") 
QConsumes (MediaType.APPLICATION JSON) 
QProduces(MediaType.APPLICATION JSON) 
public MyBean postPojoDefault(GDefaultValue("21") QQueryParam("a 
ge") int age, 
@DefaultValue("www.waylau.com")@QueryParam("name") Strin 

g name) { 

MyBean pojo - new MyBean(); 

pojo.setName(name); 

pojo.setAge(age); 

return pojo; 


启动 服务 ， 在 RESTClient 里 面 发 送 POST 请 求 调用 
http://localhost:8080/webapi/myresource/pojo 接口 ， 如 果 该 请 求 包 含 参 
数 ， 则 将 参数 值 以 对 象形 式 放 回 ， 和 否则 ， 将 默认 值 以 对 象形 式 放 回 


例如 ， 当 我 们 的 请 求 是 http://localhost:8080/webapi/myresource/pojo? 
age=26&name=waylau 


则 返回 
{ 
"age": 26, 
"name": "waylau" 
} 


3 RM 89 44 KRÆ http://localhost:8080/webapi/myresource/pojo 


则 返回 默认 值 


"age": 21, 
"name": "www.waylau.com" 


@FormParam 


@FormParam 顾名思义 是 处 理 HTML 表 单 请 求 的 。 要 求 所 请 求 MIME 媒体 类 型 为 
application/x-www-form-urlencoded ， 并 且 符 合 指定 的 HTML 编码 的 形式 ， 
此 参数 提取 对 于 HTML 表单 POST 请 求 是 非常 有 用 的 。 比 如 ， 我 们 要 处 理 一 个 登 


陆 表 单 ， 处 理 如 下 : 


@POST 
QConsumes (MediaType.APPLICATION FORM URLENCODED) 
QProduces(MediaType.APPLICATION JSON) 


public Response login(QFormParam("username") String username, 


QFormParam("password") String password) ( 
// 业 务 逻 辑 省 略 ... 
return null; 


其 他 的 参数 注解 还 包括 


e @MatrixParam 从 URL 路 径 提取 信息 

e @HeaderParam 从 HTTP 头 部 提取 信息 

e Q@CookieParam 从 关联 在 HTTP 头 部 的 cookies 里 提取 信息 

e @BeanParam 允许 注入 参数 到 一 个 bean 

e @Context 一 般 可 以 用 于 获得 一 个 Java 类 型 关联 请 求 或 响应 的 上 下 文 。 


Tp A 
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File Upload and Download 文件 上 传 、 下 载 


文件 上 传 下 载 ， 是 一 般 管 理 系统 中 经 常会 使 用 的 操作 。 下 面 介绍 下 REST 里 面 是 如 
何 实现 的 。 

FileResource 

我 们 在 com.waylau.rest.resource 目录 下 创建 FileResource 资源 类 ,在 里 面 写 
两 个 路 径 ，filepath 是 文件 下 载 路 径 ，serverLocation 是 文件 上 传 的 目录 。 当 然 “ 小 


柳 哥 ,txt” 这 个 文件 是 必须 存在 的 。 


private static final String filepath = "D:/ 测 试 文档 /小 柳 哥 .txt"，; 
private static final String serverLocation = "D:/ 测 试 文档 /"， 


在 FileResource 资源 类 中 添加 文件 下 载 的 代码 如 下 : 


@GET 

@Path("download" ) 

QConsumes (MediaType.APPLICATION JSON) 
QProduces(MediaType.APPLICATION OCTET STREAM) 
public Response downloadFile() { 


File file - new File(filepath); 
if (file.isFile() && file.exists()) ( 
String mt = new MimetypesFileTypeMap().getContentType(fi 


le); 
String fileName = file.getName(); 
return Response 
.Ok(file, mt) 
.header("Content-disposition", 
"attachment;filename-" + fileName) 
.header("ragma", "No-cache") 
.header("Cache-Control", "no-cache").build(); 
} else 1 
return Response.status(Response.Status.NOT FOUND) 
.entity(" 下 载 失 败 ， 未 找到 该 文件 ") . build(); 
j 
j 


QProduces(MediaType.APPLICATION OCTET STREAM) 这 里 就 说 明了 ， 文 件 将 会 
以 文件 流 的 形式 返回 给 客户 端 。 


TREP 
在 index.jsp 里 面 添加 


<p><a href="webapi/files/download">Download</a> 


测 试 


File Upload and Download LÆ Lg ` F #% 


好 了 ， 代 码 写 完 ， 我 们 启动 项 目测 试 下 。 点 击 “Download”， 此 时 ， 发 现 文件 的 名 


称 不 见 了 。 


y http:;/flocalhost:8080/  uA«——————7 


0000 NEM gg- ا‎ 


Jersey RESTful Web Application! 
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POIO JSON 

POJO XML SBE! : Text Document (27 3ET5) 
来 源 : http://localhost:8080 

Download 


SES Firefox 如 何 处 理 此 文件 ? 
Visit www.waylau.comfor| — puun 


O 保存 文件 G) HE SH 


L.] 以 后 自动 采用 相同 的 动作 处 理 此 米 文件。 这 


这 是 因为 系统 解析 不 了 编码 导致 的 。 需 要 将 文件 名 称 编码 做 下 转化 即 可 : 


// 处 理 文件 名 称 编码 
fileName = new String(fileName.getBytes("utf-8"),"IS08859-1"); 


再 次 启动 测试 : 
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File Upload and Download 文件 上 传 、 下 载 


http://localhost:8080/ 


(<E 


ET: 





| Jersey RESTfu 


Jersey resource 


POJO ISON 文件 类 型 ;Text Document (27 75) 
| 来 源 : http://localhost:8080 


POJO XML SABE Firefox 如 何 处 理 此 文件 ? 
| Download © 打开 方式 [D) ICRA GRN 
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O 以 后 自动 采用 相同 的 动作 处 理 | 此 湛 文 件 。 轴 
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Jersey resource = 1 
| 2010 ISON ! 
| وروم‎ XML 
Download 


Visit www. waylau.com fq 





OK ， 下 载 程序 写 完 。 


处 理 大 数量 传 参 下 载 的 问题 
有 时 难免 要 传递 的 参数 较 大 ，GET 请 求 难 以 胜任 ， 只 能 用 POST 来 请 求 下 载 。 
下 面 例 子 就 是 用 一 个 隐藏 的 Form 表单 来 传 参 进 行文 件 的 下 载 : 
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var exportUrl = 'rest/files/excel/easyui-datagird' 
var form=$("<form>");// 定 义 一 个 form 表 单 
form.attr("style","display:none"); 
form.attr("target",""); 
form.attr("method","post"); 
form.attr("action",exportUr1); 

var inputi-$("«input»"); 
inputi.attr("type"," hidden"); 
inputi.attr("name","fileName"); 
inputi.attr("value",fileName); 

var input2-$("«input»"); 
input2.attr("type", hidden"); 
input2.attr("name","columns"); 
input2.attr("value", JSON.stringify(columns) ); 
var input3-$("«input»"); 
input3.attr("type", hidden"); 
input3.attr("name", "rowsData"); 
input3.attr("value", JSON.stringify(rows) ); 
$("body").append(form);// 将 表单 放置 在 页 面 中 
form.append(input1); 

form.append(input2); 

form.append(input3); 
form.submit().remove();;// م‎ 27 


AF > input 就 是 用 来 传递 参数 的 。input 的 name 属性 是 参数 的 名 称 ，value 属性 
是 参数 的 值 。 


服务 端 要 做 如 下 的 处 理 : 


@POST 
@Path("excel/easyui-datagird" ) 
QConsumes (MediaType.APPLICATION FORM URLENCODED) 
QProduces(MediaType.APPLICATION OCTET STREAM) 
public Response jsonToExcle(QFormParam("fileName") String fileNa 
me, 

QFormParam("columns") String columns, 

QFormParam("rowsData") String rowsData) { 

// 这 里 是 处 理 的 业务 逻辑 代码 


RENE 


上 传 文件 稍微 要 复杂 ， 需 要 multipart/form-data 请 求 。 


依赖 
添加 jersey-media-multipart 到 pom.xml 


<dependency> 
<groupId>org.glassfish.jersey.media</groupId> 
<artifactId>jersey-media-multipart</artifactId> 
</dependency> 


并 在 RestApplication 里 面 注册 MultiPart 


public class RestApplication extends ResourceConfig { 


public RestApplication() { 
// 资 源 类 所 在 的 包 路 径 
packages("com.waylau.rest.resource"); 


// 注 册 MultiPart 
register(MultiPartFeature.class); 
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在 FileResource 资源 类 中 添加 文件 下 载 的 代码 如 下 : 


@POST 
QPath("upload") 
QConsumes (MediaType.MULTIPART FORM DATA) 
QProduces("application/json") 
public Response uploadFile( 
QFormDataParam("file") InputStream fileInputStream, 
@FormDataParam("file") FormDataContentDisposition conten 
tDispositionHeader ) 
throws IOException { 


String fileName = contentDispositionHeader.getFileName(); 


File file = new File(serverLocation + fileName); 

File parent = file.getParentFile(); 

// 判 断 目录 是 否 存在 ， 不 在 创建 

if(parent !=null&&! parent.exists()){ 
parent.mkdirs(); 


} 


file.createNewFile(); 

OutputStream outpuStream = new FileOutputStream(file); 

int read = 0; 

byte[] bytes = new byte[1024]; 

while ((read = fileInputStream.read(bytes)) != -1) 1 
outpuStream.write(bytes, 0, read); 

outpuStream.flush(); 

outpuStream.close(); 


fileInputStream.close(); 


return Response.status(Response.Status.OK) 
.entity("Upload Success!").build(); 


File Upload and Download LÆL ` FR 


在 index.jsp 写 一 个 上 传 的 Form 表单 


<h3>Upload a File</h3> 
<form action="webapi/files/upload" method="post" enctype="multip 
art/form-data"> 


<p> 
Select a file : <input type="file" name-"file" size="50" /> 
</p> 
<input type="submit" value="Upload It" /> 
</form> 
测试 


选择 文件 ， 点 击 “Upload lt*， 上 传 成 功 


http:/flocalhost:8080/ x 


| (€ > © http://localhost:8080 9 re 
Oo SC NS a 








Jersey RESTful Web Application! 


| 
Jersey resource 


| POJO JSON 
POJO XML 


Download 





Upload a File 


4— 
Select a file : svg-file-test.svg 


Upload It 


Visit www. waylau.com for more information on Jersey! 
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File Upload and Download 文件 上 传 、 下 载 








本 地 磋 盘 (D) > 测试 文档 ”| 好 | sex msc 
IAM 帮助 (H) 
共享 " 新 建文 件 夫 822 * 
1^ SR E 修改 日 期 类 型 
1 E) svg-file-testsvg هه‎ 一 一 2015/3/4 17:34 SVG 文档 
L1 小 覆 哥 .bxt 2015/3/4 16:22 SÆR 
c 
源码 


Jl file-upload-down ° 


参考 


e 突破 URL 传 值 限 制 http://www.waylau.com/url-length-limitation/ 
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用 SSE 构建 实时 Web 应 用 


在 标准 的 HTTP 请 求 -响应 的 情况 下 ,客户 端 打开 一 个 连接 ,发 送 一 个 HTTP 请 求 (例如 
HTTP GET 请 求 ) 到 服务 端 ,然后 接收 到 HTTP 回来 的 响应 ， 一 旦 这 个 响应 完全 被 发 
送 或 者 接收 ， 服 务 端 就 关闭 连接 。 当 客户 端 需要 请 求 所 有 数据 时 ,这 通常 总 是 由 一 个 
客户 发 起 。 


SS 


OAA 
i 
P 


Z2" 


Sas 
—— — 





p" 


相反 , Server-Sent Events (SSE) 是 一 种 机 制 ,一 旦 由 客户 端 建立 客户 机 -服务 器 的 连 
接 ， 就 能 让 服务 端 异步 地 将 数据 从 服务 端 推 到 客户 端 。 当 连接 由 客户 端 建立 完成 , 服 
务 端 就 提供 数据 ,并 决定 新 数据 " 块 "可 用 时 将 其 发 送 到 客户 端 。 当 一 个 新 的 数据 事件 
发 生 在 服务 端 时 ,这 个 事件 被 服务 端 发 送 到 客户 ai 。 因 此 ,名 称 被 称 为 Server-Sent 
Events (服务 器 推送 事件 ) 。 下 面 是 支持 服务 端 到 客户 端 交互 的 技术 总 览 : 


e 插件 提供 socket 方式 : 比如 利用 Flash XMLSocket > Java Applet 套 接 口 ， 
Activex 包装 的 socket 。 


o 优点 : 原生 socket 的 支持 ， 与 PC 端的 实现 方式 相似 ; 
o 缺点 : 浏览 器 端 需要 装 相应 的 插件 ; 与 js 进行 交互 时 复杂 
e Polling : 轮 询 ， 重 复发 送 新 的 请 求 到 服务 端 。 如 果 服 务 端 没有 新 的 数据 ， 就 发 
送 适当 的 指示 并 关闭 连接 。 然 后 客户 端 等 待 一 段 时 间 后 ,发 送 另 一 个 请 求 ( 例 如 ， 
一 秒 后 ) 


o 优点 : 实现 简单 ， 无 需 做 过 多 的 更 改 
o 缺点 : 轮 询 的 间隔 过 长 ， 会 导致 用 户 不 能 及 时 接收 到 更 新 的 数据 ; 轮 询 的 
间隔 过 短 ， 会 导致 查询 请 求 过 多 ， 增 加 服务 器 端的 负担 。 


Server 





Client 


e Long-polling : 长 轮 询 ， 客 户 端 发 送 一 个 请 求 到 服务 端 ， 如 果 服 务 端 没 有 新 的 
数据 ， 就 保持 住 这 个 连接 直到 有 数据 。 一 旦 服务 端 有 了 数据 (消息 ) AEP 
端 ， 它 就 使 用 这 个 连接 发 送 数据 给 客户 端 。 接 着 连接 关闭 。 

o 优点 : W Polling 做 了 优化 ， 有 较 好 的 时 效 性 
o 缺点 : 需 第 三 方 库 支 持 ， 实 现 较为 复杂 ; 每 次 连接 只 能 发 送 一 个 数据 ， 多 
个 数据 发 送 时 耗费 服务 器 性 能 


lime ——‏ جمدم 


Server 





e AT iframe 及 htmlfile 的 流 (streaming) 方式 : iframe 流 方式 是 在 页 面 中 插 
入 一 个 隐藏 的 iframe ， 利 用 其 src 属 性 在 服务 器 和 客户 端 之 间 创 建 一 条 长 链接 ， 
服务 器 向 iframe 传输 数据 (通常 是 HTML， 内 有 负责 插入 信息 的 


javascript) ， 来 实时 更 新 页 面 。 
o 优点 : b RE d$ KAY SGA ; 
o 缺点 : ee en ee 期 会 消耗 资源 ; iframe 不 规范 的 用 法 ; 数据 推 
送 过 程 会 有 加 载 进度 条 显示 ， 界 面体 验 不 好 


Client Server 


connection open B 
data 


data 


data 


data 


data āěë : 
connection close 
connection | open 
data $ s 


data a 


e Server-Sent events : SSE 与 长 轮 询 机 制 类 似 ,区 别 是 每 个 连接 不 只 发 送 一 个 消 
息 。 客 户 端 发 送 一 个 请 求 ， 服 务 端 就 保持 这 个 连接 直到 有 一 个 新 的 消息 "uid 
备 好 了 ,那么 它 将 消息 发 送 回 客户 端 ,同时 仍然 保持 这 个 连接 是 打开 ,这 样 这 
接 就 可 以 用 于 另 一 个 可 用 消息 的 发 送 。 一 旦 准备 好 了 一 个 新 消 has 
连接 发 送 回 客 户 端 。 客 户 端 单独 处 理 来 自 服务 端 传 回 的 消息 后 不 关闭 连接 。 所 
以 ,SSE 通常 重用 一 个 连接 处 理 多 个 消息 ( 称 为 事件 )。SSE 还 定义 了 一 个 专门 
的 媒体 类 型 text/event-stream, 描 述 一 个 从 服务 端 发 送 到 客户 端的 简单 格式 。 
SSE 还 提供 在 大 多 数 现代 浏览 器 里 的 标准 javascript 客户 端 API 实现 。 关 于 
SSE 的 更 多 信息 ,请 参见 SSE API 规范 。 

o 优点 : HTML5 标准 ; 实现 较为 简单 ; 一 个 连接 可 以 发 送 多 个 数据 
o 缺点 : IE 不 支持 EventSource( 可 以 使 用 第 三 方 的 js 库 来 解决 ， 具 体 可 以 
本 章 中 的 源码 ) ; 服务 器 只 能 单 向 推送 数据 到 客户 端 


一 人 


——»- Time 
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和 Lo Ml 





e WebSocket: WebSocket 与 上 述 技术 都 不 同 ， 因 为 它 提供 了 一 个 真正 的 全 双 工 
连接 。 发 起 者 是 一 个 客户 端 ， 发 送 一 个 带 特殊 HTTP 头 的 请 求 到 服务 端 ,通知 
服务 器 ，HTTP 连接 可 能 “升级 "到 一 个 全 双 工 的 TCP/IP WebSocket 连接 。 如 

果 服 务 端 支持 WebSocket, 它 可 能 会 选择 升级 到 WebSocket。 一 旦 建立 

WebSocket 连接 , 它 可 用 于 客户 机 和 服务 器 之 间 的 双向 通信 。 客 户 端 和 服务 器 

可 以 随意 向 对 方 发 送 数 据 。 此 时 ， 新 的 WebSocket 连接 上 的 交互 不 再 是 基于 

HTTP 协议 了 。 WebSocket 可 以 用 于 需要 快速 在 两 个 方向 上 交换 小 块 数 据 的 


在 线 游戏 或 任何 其 他 应 用 程序 。( 示 例 可 以 参考 http://www.waylau.com/netty- 


websocket-chat/) 
o 优点 : HTML5 标准 ; 大 多 数 浏览 器 支持 ; ASML: 性 能 强 


o 缺点 : 实现 相对 复杂 ; ws 协议 
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SSE vs. WebSocket 
概括 来 说 ，VWebSocket 能 做 的 ，SSE 也 能 做 ， 反 之 齐 然 ， 但 在 完成 某 些 任务 方面 ， 
它们 各 有 千秋 。 


WebSocket 是 一 种 更 为 复杂 的 服务 端 实现 技术 ， 但 它 是 真正 的 双向 传输 技术 ， 既 能 
从 服务 端 向 客户 端 推送 数据 ， 也 能 从 客户 端 向 服务 端 推送 数据 。 


WebSocket 和 SSE 的 浏览 器 支持 率 差不多 ,除了 IE。IE 是 个 例外 ， 即 便 IE11 都 还 
支持 原生 SSE > IE10 0 ES 2 ， 可 见 上 图 。 


与 WebSocket 相 比 ，SSE 有 一 些 显著 的 优势 。 我 认为 : 不 
需要 添加 任何 新 组 件 ， 用 任何 你 习惯 的 后 端 语 言 和 框架 就 能 继续 使 用 。 你 不 用 为 新 
建 虚拟 机 、 弄 一 个 新 的 IP 或 新 的 端口 号 而 劳 神 ， ee ain Ae 面 那 
样 简单 。 我 喜欢 把 这 称 为 既 存 基础 设施 优势 。 


SSE 的 第 二 个 优势 是 服务 端的 简洁 。 我 们 将 在 下 节 中 看 到 ， 服 务 端 代码 只 需 几 行 。 
相对 而 言 ， WebSocket 则 很 复杂 ， 不 借助 辅助 类 库 基本 搞 不 定 。 


因为 SSE 能 在 现 有 的 HTTP/HTTPS 协议 上 运作 ， 所 以 它 能 直接 运行 ns 
服务 器 和 认证 技术 。 而 对 WebSocket nÈ > hen 要 做 一 些 开 发 (或 其 他 
工作 ) 才能 支持 ， 在 写 这 本 书 时 ， 很 多 服务 器 还 没有 (虽然 这 种 状况 会 改善 ) e 
SSE 还 有 一 个 优势 : 它 是 一 种 文本 协议 ， م‎ pd 事实 上 ， 在 本 书 中 ， 
我 们 会 在 开发 和 测试 时 用 curl|， 甚 至 直接 在 命令 行 中 运行 后 端 脚本 。 


不 过 ， 这 就 引出 了 WebSocket 相 较 SSE 的 一 个 潜在 优势 : WebSocket 是 二 进 制 
协议 ， 而 SSE 是 文本 协议 (通常 使 用 UTF-8 编 码 ) 。 当 然 ， 我 们 可 以 通过 SSE 连 接 
传输 二 进 制 数据 : 在 SSE 中 ， 只 有 两 个 具有 特殊 意义 的 字符 ， 它 们 是 CR 和 LF > 
而 对 它们 进行 转 码 并 不 难 。 但 用 SSE 传输 二 进 制 数据 时 数据 会 变 大 ， 如 果 需 要 从 
服务 端 到 客户 端 传输 大 量 的 二 进 制 数据 ， 最 好 还 是 用 WebSocket 。 


WebSocket 相 较 SSE 最 大 的 优势 在 于 它 是 双向 交流 的 ， 这 意味 向 服务 端 发 送 数 据 
就 像 从 服务 端 接 收 数 据 一 样 简单 。 用 SSE 时 ， 一 般 通 过 一 个 独立 的 Ajax 请 求 从 客 
户 端 向 服务 端 传送 数据 。 相 对 于 WebSocket， 这 样 使 用 Ajax 会 增加 开销 ， 但 也 就 
多 一 点 点 而 已 。 如 此 一 来 ， 问 题 就 变 成 了 "什么 时 候 需 要 关心 这 个 差异 ?2 ”如果 需要 
以 1 次 / 秒 或 者 更 快 的 频率 向 服务 端 传输 数据 ， 那 应 该 用 WebSocket。0.2 次 / 秒 到 1 
次 / 秒 的 频率 是 一 个 灰色 地 带 ， 用 WebSocket 和 用 SSE 差别 不 大 ; 但 如 果 你 期 户 
重负 载 ， 那 就 有 必要 确定 基准 点 。 频 率 低 于 0.2 次 / 秒 左 右 时 ， 两 者 差别 不 大 。 


从 服务 端 向 客户 端 传输 数据 的 性 能 如 何 ? 如 果 是 文本 数据 而 非 二 进 制 数据 (如 前 文 
所 提 到 的 ) ，SSE 和 WebSocket 没 什么 区 别 。 它 们 都 用 TCP/IP 套 接 字 ， 都 是 轻 量 级 
协议 。 延 迟 、 带 宽 、 服 务 器 负载 等 都 没有 区 别 。 


在 旧版 本 浏览 器 上 的 兼容 ，WebSocket 难 兼 容 ，SSE FÅR o 


SSE 的 应 用 场景 


看 了 上 述 的 定义 ， 可 以 知道 SSE 适合 应 用 于 服务 端 单 向 推送 信息 到 客户 端的 场 
景 。Jersey 的 SSE 大 致 可 以 分 为 发 布 -订阅 模式 和 广播 模式 。 


为 使 用 Jersey SSE, 添加 如 下 依赖 : 


<dependency> 
<groupId>org.glassfish.jersey.media</groupId> 
<artifactId>jersey-media-sse</artifactId> 
</dependency> 


发 布 - 订 阅 模 式 
服务 端 代 码 : 


QPath("see-events") 
public class SseResource { 


private EventOutput eventOutput - new EventOutput(); 
private OutboundEvent.Builder eventBuilder; 
private OutboundEvent event ; 


/** 
* 提供 SSE 事件 输出 通道 的 资源 方法 

* @return eventOutput 

Ey 

@GET 
@Produces(SseFeature.SERVER_SENT_EVENTS) 
public EventOutput getServerSentEvents() { 


// 不 断 循环 执行 
while (true) { 
SimpleDateFormat df = new SimpleDateFormat("yyyy-MM- 
dd HH:mm:ss");//3k E. AMKA 
String now = df.format(new Date()); // 获 取 当 前 系统 时 间 
String message = "Server Time:" + now; 
System.out.println( message ); 


eventBuilder - new OutboundEvent.Builder(); 


eventBuilder.id(now); 
eventBuilder.name("message"); 
eventBuilder.data(String.class, 
message ); // 推送 服务 器 时 间 的 信息 给 客户 端 
event = eventBuilder.build(); 
try 1 
eventOutput.write(event); 
) catch (IOException e) 1 
e.printStackTrace(); 
) finally ( 
try 1 
eventOutput.close(); 
return eventOutput; 
) catch (IOException e) ( 
e.printStackTrace(); 


上 面 的 代码 定义 了 资源 部 署 在 URI "see-events"。 这 个 资源 有 一 个 @GET 资源 方 
法 返回 作为 一 个 实体 EventOutput 一 通用 Jersey ChunkedOutput API 的 扩展 用 
于 输出 分 块 消息 处 理 。 


客户 端 代 码 : 


// 判 断 浏 览 器 是 否 支 持 EventSource 
if (typeof (EventSource) !== "undefined") { 
var source = new EventSource("webapi/see-events"); 


// 当 通 往 服务 器 的 连接 被 打开 
source.onopen = function(event) { 
console. log( "#472 !"); 


lar 


// 当 接 收 到 消息 。 只 能 是 事件 名 称 是 message 
source.onmessage = function(event) { 
console.log(event.data); 
var data = event.data; 
var lastEventId = event.lastEventId; 
document .getElementById("x").innerHTML += "An" + 'lastEv 
entId:'+lastEventId+';data:'+data; 


}; 


// 可 以 是 任意 命名 的 事件 名 称 

/* 

source.addEventListener('message', function(event) { 
console.log(event.data); 
var data - event.data; 
var lastEventId = event.lastEventId; 
document.getElementById("x").innerHTML += "An" + 'lastEv 

entId:'+lastEventId+';data:'+data; 


3): 
*/ 


// SARRE 
source.onerror = function(event) { 
console. و10‎ ) "#7741 !"); 


3; 
} else { 

document.getElementById("result").innerHTML - "Sorry, your b 
rowser does not support server-sent events..." 


} 


首先 要 判断 浏览 器 是 否 支持 EventSource » 6/6 > EventSource 对 象 分 别 监 听 
onopen、onmessage、onerror 事件 。 其 中 ， source.onmessage = 
function(event) {} 和 source.addEventListener('message', 
function(event) {} 是 一 样 的 ， 区 别 是 ， 后 者 可 以 支持 监听 不 同名 称 的 事件 ,而 
onmessage 属性 只 支持 一 个 事件 处 理 方 法 。。 


运行 项 目 


mvn jetty:run 


浏览 器 访问 http://localhost:8080 


ava SseResourcejava web xml se-real-time-web/pom.x«ml | EJ Console 器 | [$ Package Explorer is Debug ges 


inj 
sse-real-time-web [Maven Build] CAProgram Files (x86) 
2615-68-18 20:12:58 
2815-08-18 26:13:63 


> 








y SSE 发 布 -订阅 模式 | wewwiwa... NER 





& http://localhost:8080 g-ce 加- EE <P N È f > >» = 


Jersey RESTful Web Application! 

xt = 

Get time from server 

Initializing... 

lastEventId:2015-08-18 20:12:48; data:Server Time:2015-08-18 20:12:48 
lastEventId:2015-08-18 20:12:53; data:Server Time:2015-08-18 20:12:53 


lastEventId:2015-08-18 20:12:58; data:Server Time:2015-08-18 20:12:58 
lastEventId:2015-08-18 20:13:03; data:Server Time:2015-08-18 20:13:03 


Visit www. waylau. com for more information on Jersey! 


广播 模式 
务 端 代码 


QSingleton 
QPath("sse-chat") 
public class SseChatResource ( 


private SseBroadcaster broadcaster = new SseBroadcaster(); 


/** 
* 提供 SSE 事件 输出 通道 的 资源 方法 
* @return eventOutput 
EA 
@GET 
@Produces(SseFeature.SERVER_SENT_EVENTS) 
public EventOutput listenToBroadcast() 1 
EventOutput eventOutput = new EventOutput(); 
this. broadcaster .add(eventOutput) ; 
return eventOutput; 


/** 
* 提供 EA SSE 事件 通道 的 资源 方法 
* @param message 
* @param name 
me 
QPOST 
QProduces(MediaType.TEXT PLAIN) 
public void broadcastMessage(QDefaultValue("waylau.com") QQu 
eryParam("message") String message, 
QDefaultValue("waylau") @QueryParam("name") String 
name) { 
SimpleDateFormat df = new SimpleDateFormat("yyyy-MM-dd H 
H:mm:ss");// 设 置 日 期 格式 
String now = df.format(new Date()); // 获 取 当 前 系统 时 间 
message = now +":"+ name +":"+ message; // 发 送 的 消息 带 上 
当前 的 时 间 


OutboundEvent.Builder eventBuilder = new OutboundEvent.B 

uilder(); 

OutboundEvent event = eventBuilder.name("message" ) 
.mediaType(MediaType.TEXT PLAIN TYPE) 
.data(String.class, message) 

.build(); 


// 发 送 广播 


broadcaster.broadcast(event); 


其 中 ，SseChatResource 资源 类 用 Singleton 注解 ， 告 诉 Jersey 运行 时 ， 资 源 
类 只 有 一 个 实例 ， 用 于 所 有 传 入 /sse-chat 路 径 的 请 求 。 应 用 程序 引用 私有 的 
broadcaster 字段 ， 这 样 我 们 为 所 有 请 求 可 以 使 用 相同 的 实例 。 客 户 端 想 监 听 SSE 
事件 ， 先 发 送 GET 请 求 到 sse-chat 的 listenToBroadcast() 资源 方法 处 理 。 方 法 
创建 一 个 新 的 EventOutput 用 于 展示 请 求 的 客户 端的 连接 ， 并 通过 
add(EventOutput) 注册 eventOutput 实例 到 单 例 broadcaster。 方 法 返回 
eventOutput 导致 Jersey 使 请 求 的 客户 端 事件 与 eventOutput 实例 绑 定 ， 向 客户 机 
发 送 响应 HTTP 头 。 客 户 端 连接 保持 开放 ， 客 户 端 等 待 准备 接收 新 的 SSE 事件 。 
所 有 的 事件 通过 broadcaster 写 入 eventOutput。 这 样 开发 人 员 可 以 方便 地 处 理发 
送 新 的 事件 到 所 有 订阅 的 客户 端 。 


当 客 户 端 想 要 广播 新 消息 给 所 有 的 已 经 监听 SSE 连接 的 客户 端 时 ， 它 先 发 送 一 个 
POST 请 求 将 消息 内 容 发 到 SseChatResource 资源 。SseChatResource 资源 调用 
方法 broadcastMessage， 消 息 内 容 作为 输入 参数 。 一 个 新 的 SSE 出 站 事件 是 建立 
在 标准 方法 上 并 传递 给 broadcaster。broadcaster 内 部 在 所 有 注册 了 的 
EventOutput 上 调用 write(OutboundEvent) 。 当 该 方法 只 返回 一 个 标准 文本 响应 给 
客户 端 ， 来 通知 客户 端 已 经 成 功 广 播 了 消息 。 正 如 您 可 以 看 到 的 ， 
broadcastMessage 资源 方法 只 是 一 个 简单 的 JAX-RS 资源 的 方法 。 


您 可 能 已 经 注意 到 ，Jersey SseBroadcaster 完成 该 用 例 不 是 强制 性 的 。 每 个 
EventOutput 可 以 只 是 存储 在 收集 器 里 ， 在 broadcastMessage 方法 里 面 失 代 。 然 
而 ，SseBroadcaster 内 部 会 识别 和 处 理 客户 端 断 开 连 接 。 当 客户 端 关闭 了 连接 ， 
broadcaster 可 检测 并 删除 过 期 的 在 内 部 收集 器 里 面 注册 了 EventOutput 的 连接 ， 
以 及 释放 所 有 服务 器 端 关联 了 陈旧 连接 的 资源 。 此 外 ，SseBroadcaster 的 实现 是 线 
程 安全 的 ， 这 样 客户 端 可 以 在 任何 时 间 连 接 和 断 开 ，SseBroadcaster 总 是 广播 消 
息 给 最 近 收 集 的 注册 和 活跃 的 客户 端 。 


端 代 码 : 


// 判 断 浏览 器 是 否 支 持 EventSource 
if (typeof (EventSource) !== "undefined") { 
var source = new EventSource("webapi/sse-chat"); 


// 当 通 往 服务 器 的 连接 被 打开 

source.onopen = function(event) { 
var ta = document.getElementById('response text'); 
ta.value = ' 连 接 开 启 !'， 

}; 


// 当 接 收 到 消息 。 只 能 是 事件 名 称 是 message 

source.onmessage = function(event) { 
var ta = document.getElementById('response text'); 
ta.value = ta.value + '\n' + event.data; 


Jer 


// 可 以 是 任意 命名 的 事件 名 称 

SES 

source.addEventListener('message', function(event) { 
var ta = document.getElementById('response text'); 
ta.value = ta.value + '\n' + event.data; 


3); 
*/ 


// SARRE 

source.onerror = function(event) { 
var ta = document.getElementById('response text'); 
ta.value = ta.value + '\n' + "连接 出 错 1"， 


}; 
} else { 

alert("Sorry, your browser does not support server-sent even 
Dou 


j 


function send(message) { 
var xmlhttp; 
var name - document.getElementById('name id').value; 


if (window.XMLHttpRequest) 

{// code for IE7+, Firefox, Chrome, Opera, Safari 
xmlhttp=new XMLHttpRequest(); 

} 


else 


Build Real-Time Web A 





{// code for IE6, IE5 
xmlhttp-new ActiveXObject("Microsoft.XMLHTTP"); 


xmlhttp.open("POST", "webapi/sse-chat?message=" + message +'& 
name=' + name ,true); 


xmlhttp.send(); 


EventSource 的 用 法 与 发 布 -订阅 模式 类 似 。 而 send(message) 方法 是 将 消息 以 
POST 请 求 发 送 给 服务 端 ， 而 后 将 该 消息 进行 广播 ， 从 而 达到 了 聊天 室 的 效果 。 


AX 
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-05-15 


SSE 广播 模式 -聊天 | wwa. (+ 





s ——————————— Huy [o Sse FARER | we x VLC 
€ @ http:f/localhost:S080/sse broadcast 19 E& — C 四 c D localhost:8080/sse broadcast.html 


Jersey RESTful Web Applicatiom Jersey RESTful Web Application! 


Index Index 

SSE Chat SSE Chat 

SSE WAZ: SSE WAZ: 

连接 开局 ! 连接 开启 ! 

2015-08-18 20:13:3b:waylau:Welcome to www.waylau]| 2015-08-18 20:14:16: funny: PRAF IE" 

2015-08-18 20:14:16:funny: 你 好 啊 Sa 2 i s HARI 

2015-08-18 20:14:33:waylau: 你 好 啊 ， 靓 妹 ! 114:46: funny: AE 

2015-08-18 20:14:46:funny: 又 是 加 班 

waylau hel. AMAR! 1 funny | REME FEE 





Visit www. waylau. com for more information on Jerg visit www wavlau. com for more information on Jersey! 


相关 问题 


Fb tH E 


报 如 下 错误 : 


^H 18, 2015 7:48:28 TF org.glassfish.jersey.servlet.internal. 
Responsewriter suspend 
WARNING: Attempt to put servlet request into asynchronous mode h 
as failed. Please check your servlet configuration - all Servlet 
instances and Servlet filters involved in the request processin 
g must explicitly declare support for asynchronous request proce 
ssing. 
java.lang.IllegalStateException: !asyncSupported 

at org.eclipse.jetty.server.Request.startAsync(Request. java: 
2072) 

at org.glassfish.jersey.servlet.async.AsyncContextDelegatePr 
oviderImpl$ExtensionImpl.getAsyncContext(AsyncContextDelegatePro 
viderImpl.java:112) 

at org.glassfish.jersey.servlet.async.AsyncContextDelegatePr 
oviderImpl$ExtensionImpl.suspend(AsyncContextDelegateProviderImp 
1.java:96) 

at org.glassfish.jersey.servlet.internal.ResponseWriter.susp 
end(ResponseWwriter.java:121) 

at org.glassfish.jersey.server.ServerRuntime$Responder.write 
Response(ServerRuntime.java:747) 

at org.glassfish.jersey.server.ServerRuntime$Responder.proce 
ssResponse(ServerRuntime.java:424) 

at org.glassfish.jersey.server.ServerRuntime$Responder.proce 
ss(ServerRuntime.java:414) 

at org.glassfish.jersey.server.ServerRuntime$2.run(ServerRun 
time.java:312) 

at org.glassfish.jersey.internal.Errors$1.call(Errors.java:2 
71) 

at org.glassfish.jersey.internal.Errors$1.call(Errors.java:2 
67) 

at org.glassfish.jersey.internal.Errors.process(Errors.java: 
315) 

at org.glassfish.jersey.internal.Errors.process(Errors.java: 
297) 

at org.glassfish.jersey.internal.Errors.process(Errors.java: 
267) 

at org.glassfish.jersey.process.internal.RequestScope.runInS 
cope(RequestScope. java:317) 

at org.glassfish.jersey.server.ServerRuntime.process(ServerR 


untime.java:292) 

at org.glassfish.jersey.server.ApplicationHandler.handle(App 
licationHandler.java:1139) 

at org.glassfish.jersey.servlet.WebComponent.service(WebComp 
onent.java:460) 

at org.glassfish.jersey.servlet.ServletContainer.service(Ser 
vletContainer.java:386) 

at org.glassfish.jersey.servlet.ServletContainer.service(Ser 
vletContainer.java:334) 

at org.glassfish.jersey.servlet.ServletContainer.service(Ser 
vletContainer.java:221) 

at org.eclipse.jetty.servlet.ServletHolder.handle(ServletHol 
der.java:808) 

at org.eclipse.jetty.servlet.ServletHandler.doHandle(Servlet 
Handler.java:587) 

at org.eclipse.jetty.server.handler.ScopedHandler.handle(Sco 
pedHandler.java:143) 

at org.eclipse.jetty.security.SecurityHandler.handle(Securit 
yHandler.java:577) 

at org.eclipse.jetty.server.session.SessionHandler .doHandle( 
SessionHandler. java: 223) 

at org.eclipse.jetty.server.handler.ContextHandler.doHandle( 
ContextHandler.java:1127) 

at org.eclipse.jetty.servlet.ServletHandler.doScope(ServletH 
andler.java:515) 

at org.eclipse.jetty.server.session.SessionHandler.doScope(S 
essionHandler.java:185) 

at org.eclipse.jetty.server.handler.ContextHandler.doScope(C 
ontextHandler.java:1061) 

at org.eclipse.jetty.server.handler.ScopedHandler.handle(Sco 
pedHandler.java:141) 

at org.eclipse.jetty.server.handler.ContextHandlerCollection 
.handle(ContextHandlerCollection.java:215) 

at org.eclipse.jetty.server.handler.HandlerCollection.handle 
(HandlerCollection.java:110) 

at org.eclipse.jetty.server.handler.HandlerWrapper.handle(Ha 
ndlerwrapper.java:97) 

at org.eclipse.jetty.server.Server.handle(Server.java:497) 

at org.eclipse.jetty.server.HttpChannel.handle(HttpChannel. j 
ava: 310) 


at org.eclipse.jetty.server.HttpConnection.onFillable(HttpCo 
nnection.java:257) 

at org.eclipse.jetty.io.AbstractConnection$2.run(AbstractCon 
nection.java:540) 

at org.eclipse.jetty.util.thread.QueuedThreadPool.runJob(Que 
uedThreadPool.java:635) 

at org.eclipse.jetty.util.thread.QueuedThreadPool$3.run(Queu 
edThreadPool. java:555) 

at java.lang.Thread.run(Thread. java: 722) 


是 指 服 务 器 不 支持 异步 请 求 。 解 决 方法 是 在 web.xml 中 添加 


<async-supported>true</async-supported> 


最 后 的 web.xml X : 


<web-app xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema- instance" 
xmlns-"http://xmlns.jcp.org/xml/ns/javaee" 
xsi:schemaLocation-"http://xmlns.jcp.org/xml/ns/javaee http: 
//xmlns.jcp.org/xm1/ns/javaee/web-app 3 1.xsd" 
id-"WebApp ID" version="3.1"> 


<servlet> 
<servlet-name>Jersey Web Application</servlet -name> 
<servlet-class>org.glassfish.jersey.servlet.ServletConta 
iner</servlet-class> 
<init -param> 
<param-name>javax.ws.rs.Application</param-name> 
<param-value>com.waylau.rest.RestApplication</param- 
value> 
</init-param> 
<load-on-startup>1</load-on-startup> 
<async-supported>true</async-supported> 
</servlet> 
<servlet -mapping> 
<servlet-name>Jersey Web Application</servlet -name> 
<url-pattern>/webapi/*</url-pattern> 
</servlet -mapping> 
</web-app> 


跨 域 请 求 


由 于 浏览 器 同 源 策 略 ， 凡 是 发 送 请 求 url 的 协议 、 域 名 、 端 口 三 者 之 间 任 意 一 与 当前 
页 面 地 址 不 同 即 为 跨 域 。 


URL 说 明 是 否 允 许 通信 


http://www.a.com/a.js sk : 
http://www.a.com/b.js aa fest 


http://www.a.com/lab/a.js 同一 域名 下 不 同文 Ad 
http://www.a.com/script/b.js — fF3X 


http:/www.a.com:8000/a.js ”同一 域名 ， 不 同 端 不 允许 


http://www.a.com/b.js zi 

http://www.a.com/a.js 同一 域名 ， 不 同 协 RAH 
https://www.a.com/b.js 5 

http://www.a.com/a.js Á Zum TE 
http://70.32.92.74/b js ESE ME 
http://www.a.com/a.js 主 域 相 同 ， 子 域 不 不 多 许 
http://script.a.com/b.js 同 

http://www.a.com/a.js 同一 域名 ， 不 同 二 ”不 允许 (cookie 这 种 情况 
http://a.com/b.js 级 域名 (同上) 下 也 不 允许 访问 ) 
http://www.cnblogs.com/a.js 不 同 域名 不 允许 


http://www.a.com/b.js 


出 于 安全 考虑 ， 默 认 是 不 允许 跨 域 访问 的 ， 会 报 如 下 异常 : 


e Firebug - EventSource example mmm 
9 Hy € > OS | Bav HTML css BA DOM 网 络 Cookies ممه دعت عم‎ ^ - BOG 
lo | 清除 & "UN 23 dx SS BE BREE Cookies 

D BHRERGENXOGEGRAe HERE GÆR http://192. 168. 11, 125:8080/webapi/see-events LATER. WLS RRB AHS LMS SR CORS 来 解决 这 个 问题 。 

© Firefox HÆL Z 3) http: //192. 168. 11. 125:8080/webapi/see-events FEDE. sse test htmi (第 9 fy; 


var es = new EventSource "http: //192. 168. 11. 125:8080/webapi/see-events") 


解决 是 服务 器 启动 CORS e 


先是 做 一 个 过 滤器 CrossDomainFilter.java， 将 响应 头 “Access-Control-Allow- 
Origin X EA” 


Qoverride 
public void filter(ContainerRequestContext requestContext, 


ContainerResponseContext responseContext) throws IOExcep 
tion { 


// 响应 头 添加 了 对 允许 访问 的 域 ，* 代表 是 全 部 域 


responseContext.getHeaders().add("Access-Control-Allow-Origi 
mee use): 


在 RestApplication 里 ， 注 册 该 过 滤器 即 可 。 


public class RestApplication extends ResourceConfig { 


public RestApplication() { 
// 资源 类 所 在 的 包 路 径 
packages("com.waylau.rest.resource"); 


// 注册 MultiPart 
register (MultiPartFeature.class); 


// 注册 CORS 过 滤器 
register(CrossDomainFilter.class); 


这 样 ， 就 能 跨 域 访问 了 ， 如 下 ，192.168.11.103 可 以 访问 192.168.11.125 站 下 的 
资源 





Build Real-Time Web App with SSE 用 SSE 构建 实时 Web 应 用 


J SSE 的 CORS| www.waylau.c... \ + 





€ |& 192.168.11.103:8080/sse_cors.html 


Ui 5 e 图- BE <Ctrl+K> 














Pe ata 











192, 168. 11.125:808C 
192. 168, 11. 125:808C 
192, 168. 11.125:808C 
192. 168. 11. 125:808C 


192. 168. 11.125:808C 


SSE 的 CORS |e Hy > > >E gaa HTML css Be DOM | 网 络 ”| Cookies 
m lå | 清除 Ge |] SEB) HTML CSS JavaScript XHR HE fk 媒体 字体 
a | URL | 状态 E3 | 大 小 GEBIP 
EE Due sa RBTÉPAEG.REEAEEHDEEGRASTAWET. 

H GET see-events 200 OK 192.168.11.125:8080 78B 
Initializing 由 GET see-events 200 OK 192.168.11.125:8080 78B 
lastEventId:2015-08-22 15:19:25:data:Server Tif MEME عدت‎ ne 

ME ivit buda | http://192.168.11.125:8080/webapi/see-events 5: 

lastEventld:2015-08-22 15:19:30;data:Server Til 9 192.168.11.1 see-events 5:8080 788 
lastÉventId:2015-08-22 15:19:35;data:Server Tij... GETsee events 800K à.  192.168.11.125:8080 738 

SHER 3908 


lastEventid:2015-08-22 15:19:40;data:Server Ti] 一 一 


lastEventId:2015-08-22 15:19:45;data:Server Til 
lastEventld:2015-08-22 15:19:50;data:Server Tij 
lastEÉventIid:2015-08-22 15:19:55;data:Server Tit 


Visit www. waylau. com for more information on J| 


源码 


见 sse-real-time-web 项 目 


参考 : 


Jersey 2.x 用 户 指南 


Data Push Apps with HTMLS SSE (by Darren Cook) 


http://www.ibm.com/developerworks/cn/web/wa-lo-comet/ 
https://developer.mozilla.org/en-US/docs/Web/HTTP/Access_control_CORS 
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